更新时间:2023-12-07
1功能简介
客户部署无线网络想要实现实名制认证获取用户手机号码,那么就需要控制器对接短信平台或者短信猫配置短信认证的无线网络。
无线控制器的短信服务分为两种发送模块方式,分别是短信猫和短信网关。
2短信服务配置
2.1对接短信猫
短信猫分为两种,分别是GSM短信猫和CDMA短信猫。GSM短信猫适用于移动SIM卡和联通SIM卡,CDMA短信猫仅支持电信SIM卡。
无线控制器管理页面【平台管理】-【平台服务】-【短信服务】启用短信服务,发送模块选择本设备串口连接短信猫。
1、网关类型:分为GSM短信猫和CDMA短信猫。
2、短信中心:网关类型为GSM短信猫,则需要配置短信中心号码,可以联系运营商查询SIM卡归属地的短信中心号码。CDMA短信猫不需要配置短信中心号码。
3、使用串口:控制器串口默认是COM0。
4、串口波特率:控制器串口波特率默认是115200。
注意:我们的短信猫仅支持SIM卡的2G信号,需要保证安装短信猫位置有2G信号(将SIM卡安装到手机调成2G信号模式测试是否能成功发送短信,来检测SIM卡是否正常工作)。
2.2对接短信网关
控制器支持对接中国移动、中国联通、中国电信以及http类型的短信平台,不支持https类型的短信平台,比较常用的是http类型的短信平台,此处以http类型的短信平台示例。
无线控制器【平台管理】-【平台服务】-【短信服务】启用短信服务,发送模块选择短信网关,如下图所示。
1、网关类型:选择HTTP协议
2、URL地址:控制器请求短信平台的URL链接,根据客户提供的短信接口文档来配置此URL链接。
3、Content-Type:默认是application/text,根据客户提供的短信接口文档配置短信报头。
4、编码:支持GBK和UTF-8两种编码方式,依据短信接口文档配置编码方式。
5、SOAP版本和请求类型:根据短信平台提供的短信接口文档,这里配置soap1.1版本和get请求类型
短信模板:根据短信接口文档说明,配置URL链接必须携带的URL参数。
请求模板内容示例如下:
SpCode=216849&LoginName=admin&Password=123&MessageContent=$$SMS_CONTENT$$&UserNumber=$$MOBILE_NUM$$&SerialNumber=&ScheduleTime=&f=1
GET请求类型,可以在浏览器里面测试是否收到短信,并且可以看到短信平台回复的结果。
http://api.ums86.com:8899/sms/Api/Send.do?SpCode=216849&LoginName=admin&Password=123&MessageContent=您的验证码为xxxx&UserNumber=1872930****&SerialNumber=&ScheduleTime=&f=1
2.3对接WebService短信网关
无线控制器【平台管理】-【平台服务】-【短信服务】启用短信服务,发送模块选择短信网关。配置发送参数,网关类型选择HTTP协议,其他的参数需要参照客户提供的短信接口文档配置。
1、URL地址:请求短信网关的URL链接,根据短信接口文档查询,短信发送的URL地址是http://218.65.241.103:9088/services/WebServiceSoap?wsdl以及发送接口名称是PostSingle。
2、Content-Type:短信报头,默认是application/text,部分短信网关是json格式的,则短信报头是application/json。
3、编码:控制器默认是utf-8方式,根据客户提供的短信接口文档配置编码方式。
4、SOAP版本:根据客户提供的短信接口文档配置。
5、请求类型:对接webservice短信网关,请求类型要选择为POST方式。
6、短信模板,在浏览器打开短信发送URL地址,右击将此网页另存为一个xml文件,如下图所示。
短信模板点击设置,接口名称填写短信发送接口名称PostSingle,wsdl文件导入刚刚生成的WebServiceSoap.xml文件自动生成“请求模板”,并将模板中的参数按照占位符或者实际用户信息替换。其中,各参数的含义在接口文档中给出,一般情况下顺序一致。
2.4测试短信服务有效性
1、对接短信猫测试短信服务,输入正确的手机号码,内容随便编辑一段话测试即可
2、对接第三方短信平台测试短信服务,输入正确的手机号码,短信内容要跟短信平台设置的模板保持一致。大部分短信网关会自动加上短信签名,少部分短信网关需要手动加上短信签名,具体可以跟短信网关技术人员确认清楚。
3注意事项
1.对接短信猫,需要注意GSM短信猫支持移动和联动SIM卡,CDMA短信猫仅支持电信SIM卡。
2.我们短信猫仅支持SIM卡2G信号,需要保证短信猫所在位置有2G信号。
3.测试短信服务器有效性时,收不到验证码或者验证码接收的很慢可能是短信模板不符或者未手动配置签名,需要平台审核。