ITPub博客

创蓝253云通讯平台---短信验证码接口说明

原创 IT综合 作者:luck_yun 时间:2018-07-12 17:08:32 0 删除 编辑

1 协议说明

名称

说明

协议

HTTP POST

编码格式

UTF8

Content-Type

application/json

URL

http://xxx/msg/send/json 或者 https://xxx/msg/send/json
 
完整地址请登录253云通讯自助通平台或者询问您的商务负责人获取

接口说明

此接口一次可提交不超过1000个手机号码。

2 请求包体

包体为json字符串,参数如下:

 

{    

 "account" : "N6000001"//用户在253云通讯平台上申请的API账号    

 "password" : "123456"//用户在253云通讯平台上申请的API账号对应的API密钥    

 "msg" : "253】您的验证码是:2530"//短信内容。长度不能超过536个字符    

 "phone" : "15800000000"//手机号码。多个手机号码使用英文逗号分隔    

 "sendtime" : "201704101400"//定时发送短信时间。格式为yyyyMMddHHmm,值小于或等于当前时间则立即发送,不填则默认为立即发送(选填参数)    

 "report" : "true"//是否需要状态报告(默认为false)(选填参数)    

 "extend" : "555"//用户自定义扩展码,纯数字,建议1-3位(选填参数)    

 "uid" : "批次编号-场景名(英文或者拼音)" //自助通系统内使用UID判断短信使用的场景类型,可重复使用,可自定义场景名称,示例如 VerificationCode(选填参数)    

 }

 

注:发送短信的账号不是253平台登录账号,是短信接口API账号

 

1.  发送的短信内容一定要加上签名,账号有报备过签名的可不用带上签名, 但如果您有多个短信签名,请将需要的短信签名放在短信内容前面
例如您有253云通讯】【通讯云】两个签名,但是想以【通讯云】签名发送短信,则”msg”字段可赋值为:【通讯云】你的验证码是xxxx”,不填默认第一个签名。

2.   

用户自定义扩展码,发送短信显示号码,规则为:10690+xxx(通道号)+xxx(系统扩展码) +xxx(用户自定义扩展码);扩展码的长度将直接影响短信上行接收的接收。如需要传扩展码参数时,请咨询客服相关设置问题

 

3 应答包体

{    

 "code" : "0"//状态码    

 "msgId" : "17041010383624511"//消息Id    

 "errorMsg" : ""//失败状态码说明(成功返回空)    

 "time" : "20170410103836" //响应时间    

 }

 

注:code为响应状态码,可以和响应状态码进入对比

 


请登录后发表评论 登录
全部评论

注册时间:2017-12-08

  • 博文量
    7
  • 访问量
    922