http短信接口文档.doc

HTTP短信接口文档接口域名:、工作方式 1密码验证方式 2二、字符编码 2三、响应格式 2四、短信发送 7五、接收状态报告 11六、接收上行短信(回复) (回复) (回复) 13七、取剩余短信条数 13八、取已发送总条数 14九、取发送记录 15十、修改密码 17十一、接口安全(绑定IP) 18一、工作方式双方通过HTTP方式交互数据,第三方可以简单的“name=value”方式发送提交内容或响应请求内容。即通过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/?ac=send&uid=用户账号&pwd=MD532位密码&mobile=号码&content=:参数名参数字段参数说明ac接口功能接口功能,传入值请填写senduid用户账号登录名pwd用户密码32位MD5加密md5(密码+uid)如登录密码是:123123,uid是:test;pwd=md5(123123test)pwd=b9887c5ebb23ebb294acab183ecf0769mobile接收号码同时发送给多个号码时,号码之间用英文半角逗号分隔(,);小灵通需加区号如:**********,**********content短信内容JSON变量模板发送,传参规则{"key":"value"}JSON格式,key的名字须和申请模板中的变量名一致,多个变量之间以逗号隔开。示例:针对模板“短信验证码{$code},您正在进行{$product}身份验证,请在10分钟内完成操作!”,传参时需传入{"code":"352333","product":"电商平台"}template模板短信ID发送变量模板短信时需要填写对应的模板ID号,进入平台-》短信设置-》模板管理format返回格式可选项,有三参数值:json,xml,txt默认json格式encode字符编码可选项,默认接收数据是UTF-8编码,如提交的是GBK编码字符,需要添加参数encode=gbkmobileids消息编号可选项该参数用于发送短信收取状态报告用,格式为消息编号+逗号;与接收号码一一对应,可以重复出现多次。消息编号:全部由数字组成接收状态报告的时候用到,该消息编号的格式可就为目标号码+当前时间戳整数,精确到毫秒,确保唯一性。供收取状态报告用如:15900491111**********;例:你在平台添加了JSON变量模板如下:短信验证码{$code},您正在进行{$product}身份验证,请在10分钟内完成操作!模板ID:100001接收号:**********接口内容JSON格式:{"key":"234336","product":"电商平台"}http://api./sms/?ac=send&uid=test&pwd=b9887c5ebb23ebb294acab183ecf0769&mobile=**********&content={"key":"234336","product":"电商平台"}&template=100001注:发送内容content需要进行URL字符标准化转码。响应结果值:json格式{"stat":"100","message":"发送成功"}xml格式<result><stat>100</stat><message>发送成功</message></result>txt文本字符格sms&stat=100&message=发送成功返回发送的状态码状态码说明 100发送成功 101验证失败 102短信不足 103操作失败 10