DOC《HTTPS/HTTP接口文档》

HTTPS/HTTP接口文档 接口域名:api.

sms.cn

一、工作方式

2 SMS支持HTTPS短信接口和HTTP短信接口,建议使用HTTPS

2 密码验证方式

2

二、字符编码

2

三、响应格式

2

四、短信发送

2 4.1变量模板发送

2 4.2全文发送(全文模板)

4 4.3 全文变量模板一对一多条发送

6

五、接收状态报告

7 5.1 主动获取状态

7 5.2 推送接收状态报告

9

六、接收上行短信(回复)

9 6.1 主动获取上行短信(回复)

9 6.2 推送接收上行短信(回复)

11

七、取剩余短信条数

11

八、取已发送总条数

12

九、取发送记录

12

十、短信模板管理

14 10.1 添加短信模板

15 10.2 短信模板审核状态查询

16 10.3 取短信模板记录

17 十

一、修改密码

19 十

二、接口安全(绑定IP)

20

一、工作方式 SMS支持HTTPS短信接口和HTTP短信接口,建议使用HTTPS 双方通过HTTPS或HTTP方式交互数据,第三方可以简单的 name=value 方式发送提交内容或响应请求内容.即通过HTTPS或HTTP的GET/POST方式交换. 另外双方需要保证数据传输的完整性和安全性,每次发送请求都有响应(响应返回格式为纯文本),安全验证目前采用用户名、密码和IP绑定的方式. 密码验证方式 接口密码使用 登录密码 与 用户名 拼接字符串后能过md5加密进行验证 如登录密码是:123123 如用户名是:test 接口密码(pwd)=md5(登录密码+用户名) pwd=md5(123123test) pwd=b9887c5ebb23ebb294acab183ecf0769 接口密码可以直接登录短信平台从? 短信设置 ->

? 接口密码 获取

二、字符编码 服务器接收数据可以是GBK或UTF-8编码字符;

默认接收数据是UTF-8编码,如提交的是GBK编码字符,需要添加参数encode=gbk.

三、响应格式 所为响应即每次向服务器提交请求后返回值 响应值格式有:JSON、XML、纯文本 默认:JSON格式

四、短信发送 GET/POST操作格式: http://api.sms.cn/sms/?ac=send&

uid=用户账号&

pwd=MD532位密码&

mobile=号码&

content=内容 4.1变量模板发送 接口参数说明: 参数名 参数字段 参数说明 ac 接口功能 接口功能,传入值请填写 send format 返回格式 可选项,有三参数值:json,xml,txt 默认json格式 uid 用户账号 登录名 pwd 用户密码 32位MD5加密md5(密码+uid) 如登录密码是:123123 ,uid是:test;

pwd=md5(123123test) pwd=b9887c5ebb23ebb294acab183ecf0769 encode 字符编码 可选项,默认接收数据是UTF-8编码,如提交的是GBK编码字符,需要添加参数 encode=gbk mobile 接收号码 同时发送给多个号码时,号码之间用英文半角逗号分隔(,);

小灵通需加区号 如:13972827282,13072827282 mobileids 消息编号 可选项 该参数用于发送短信收取状态报告用,格式为消息编号+逗号;

与接收号码一一对应,可以重复出现多次. 消息编号:全部由数字组成接收状态报告的时候用到,该消息编号的格式可就为目标号码+当前时间戳整数,精确到毫秒,确保唯一性.供收取状态报告用 如: 1590049111112869461937;

content 短信内容 变量模板发送,传参规则{ key : value }JSON格式,key的名字须和申请模板中的变量名一致,多个变量之间以逗号隔开.示例:针对模板 短信验证码{$code},您正在进行{$product}身份验证,请在10分钟内完成操作! ,传参时需传入{ code :

352333 , product : 电商平台 } template 模板短信ID 发送变量模板短信时需要填写对应的模板ID号,进入平台-》短信设置-》模板管理 language 状态说明语言 language=english message状态说明返回英文{ stat :