专门为需要【手机短信验证码】使用场景而设计的微服务(Micro service)，如：用户注册、找回密码、用户身份验证、验证码登录等等。
首先我没有找到已实现这些基本功能合一的轮子，至少开源的没有。而实际上我们很多项目开发时经常需要用到手机验证码功能。然而每次重复造轮子又觉得太繁琐且不容易集中控制。于是有了开发一个可复用轮子的想法。那么合计不到1500行Go代码实现这个可复用的手机验证码微服务何乐不为呢？
得益于Go语言的跨平台支持，SmsCode可安装在所有主流OS上（Linux，Mac OS X，FreeBSD，Windows，ARM等）
推荐Linux x64上安装SmsCode，编译安装请确保已经在OS上安装了Go的编译环境。
go get -u github.com/xluohome/smscode
cd $GOPATH/src/github.com/xluohome/smscode
./build && ./smscode
- 支持阿里大鱼、云通讯等多个手机短信验证码通道;
- 自定义多个手机验证码短信服务接口，如：注册服务，重设密码，身份验证等等;
- 支持手机号归属地限制，只允许指定的归属地手机号接收短信验证码;
- 每个短信验证码服务可设置每日发送数量限额及失效时间;
- 内置callback服务，可设置短信验证码发送成功（失败）、验证码验证成功时的回调URL;
- 可设置短信验证码发送模式:
- 0x01：只有手机号对应的uid存在时才能发送。
- 0x02：只有uid不存在时才能发送。
- 0x03：不管uid是否存在都发送。
- 通过setuid接口可将现有系统中的用户UID数据导入SmsCode;
- 内置持久化存储：Goleveldb;
- 支持Docker部署，SmsCode静态编译docker image不到8mb;
bind: 0.0.0.0:8080 #短信验证码微服务器地址
juheapikey: aaaaaaaaaaaaaaaadddddddd #手机号归属地信息获取接口 https://www.juhe.cn/
vendors:
alidayu: #阿里大鱼配置 http://www.alidayu.com
appkey: 20315570
appSecret: 87hfgfg75775765787878
issendbox: false
yuntongxun: #云通讯配置 http://www.yuntongxun.com/
AccountSid: 8a48b55e434514c9c31921a039b
AccountToken: 61434dc2b245435eadf82d381fa3f
AppId: aaf98f8fsdafd2678c9d07875040f
SoftVersion: 2013-12-26
RestURL: https://app.cloopen.com:8883
errormsg:
"err_model_not_ok1": "当前用户(%s)不存在，不能发送手机验证码"
"err_model_not_ok2": "当前用户(%s)存在，不能发送手机验证码"
"err_code_not_ok": "手机验证码:%s 不正确，请重新输入"
"err_vailtime_not_ok": "手机验证码已超时:%s，请重新获取"
"err_per_day_max_send_nums": "一个手机号每天仅限发送%d条验证码"
"err_per_minute_send_num": "一个手机号每分钟仅限发送1条验证码"
"err_allow_areacode": "手机号归属地不允许，仅限于:%s"
"err_not_uid": "手机号%s对应的%s不存在或者不匹配"
servicelist:
"register":
vendor: alidayu #短信通道供应商
group: db1 #相同组内的uid数据共享
smstpl: SMS_34850248 #阿里大鱼短信模板id
signname: 罗永 #阿里大鱼短信签名
callback: "http://127.0.01/test9.php"
allowcitys: #仅限如下的手机号归属区接收验证码
- 0575
- 0571
- 0574
maxsendnums: 4 #一个手机号每天发送限额,这个受短信运营商的限制。
validtime: 600 #单位：秒 。 收到的手机验证码x秒内有效，超过后验证无效；
mode: 2 #模式 1：只有手机号对应的uid存在时才能发送，2：只有uid不存在时才能发送，3：不管uid是否存在都发送
outformat: mobcent #接口输出样式（mobcent,default）
"restpwd":
vendor: alidayu
group: db1
smstpl: SMS_39190087
signname: 罗永
callback:
allowcitys:
- 0578
maxsendnums: 2
validtime: 360
mode: 3
"getpwd":
vendor: yuntongxun
group: db1
smstpl: 149350
signname: 罗永亿
callback:
allowcitys:
- 0578
- 0575
maxsendnums: 2
validtime: 360
mode: 3
| 接口名称 | 接口地址 | 参数 | 说明 |
|---|---|---|---|
| 发送验证码 | /send | service , mobile | 服务名称,手机号 |
| 验证验证码 | /checkcode | service , mobile,code | 服务名称,手机号,验证码 |
| 设置用户UID | /setuid | service , mobile,uid | 服务名称,手机号 ,用户id |
| 删除用户UID | /deluid | service, mobile,uid | 服务名称,手机号,用户id |
| 信息查询 | /info | service, mobile | 服务名称,手机号 |
每个短信验证码服务允许设置一个callback Url ； 如下事件发生时将回调callback Url
- 手机验证码发送成功或者失败时。
- 手机验证码通过验证时。
当 callback Url 无法访问时，系统会延时2,4,6,8,16,32,64,128秒 依次进行重试（合计10次）。
成功时附带如下Url请求参数(multipart/form-data)：
mobile string #手机号
code string #验证码
service string #服务名称
uxtime int #时间戳
flag string #回调标记 (Success,Failed,Checkok)
欢迎来信交流 phposs@qq.com