新HTTP接口明文档.docVIP

HTTP接口文档 接口域名：10086./api/ 一、密码验证方式 1 二、字符编码 1 三、响应格式 2 四、短信发送（单条，多条发送） 2 五、接收状态报告 3 5.1 主动获取状态 3 六、接收上行短信（回复） 4 6.1 主动接收上行短信（回复） 4 七、取剩余短信条数 5 八、取已发送总条数 5 九、接口安全（绑定IP） 6 十、取发送记录 6 一、密码验证方式 接口密码使用“登录密码”与“用户名”拼接字符串后能过md5加密进行验证 如登录密码是：123123 如用户名是：test 接口密码（pwd）=md5(登录密码+用户名) pwd=md5(123123test) pwd=b9887c5ebb23ebb294acab183ecf0769 二、字符编码 服务器接收数据可以是GBK或UTF-8编码字符,默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数encode=utf8。请求响应返回内容是GBK编码。 三、响应格式 所为响应即每次向服务器提交请求后返回值 响应值格式为纯文本 四、短信发送（单条，多条发送） GET/POST操作格式： http://10086./api/mt/?uid=用户pwd=MD532位密码mobile=号码mobileids=消息编号content=内容 接口参数说明: 参数名 参数字段 参数说明 uid 用户b9887c5ebb23ebb294acab183ecf0769 time 定时时间 可选项，及时发送时参数无 格式:YYYY-MM-DD HH:MM　如：2010-05-27 12:01 (年-月-日 时:分),发送时间以北京时间为准 mid 子扩展号 可选项，根据用户账号是否支持扩展 encode 字符编码 可选项，默认接收数据是GBK编码,如提交的是UTF-8编码字符,需要添加参数 encode=utf8 mobile 接收号码 同时发送给多个号码时,号码之间用英文半角逗号分隔(,);小灵通需加区号 如13918395457GET　 方式每次最多可以提交50条号码 POST　方式每次最多可以提交2000条号码[建议用POST方式提交] mobileids 消息编号 可选项 该参数用于发送短信收取状态报告用，格式为消息编号+逗号；与接收号码一一对应，可以重复出现多次。 消息编号:全部由数字组成接收状态报告的时候用到，该消息编号的格式为目标号码+当前时间戳整数，精确到毫秒，确保唯一性。供收取状态报告用 如: 1590049111112869461937; content 短信内容 发送内容需要进行URL字符标准化转码。{URL字符编码说明:返回字符串，此字符串中除了-_.之外的所有非字母%）后跟+）server.URLEncode(短信内容) PHP：短信内容) JAVA：.URLEncoder.encode(短信内容) 例: 接 收 号1390000test发送内容：发送测试 http://10086./api/mt/?uid=testpwd=b9887c5ebb23ebb294acab183ecf0769mobile1390000testobileids=1390000888812869461937,1390000test12869461937,1310000666612869461937content= %B7%A2%CB%CD%B2%E2%CA%D4 发成功时响应状态码值: smsstat=100message=发送成功message 状态说明 返回发送的状态码 状态码 说明 100 发送成功 101 验证失败 102 短信不足 103 操作失败 104 非法字符 105 内容过多 106 号码过多 107 频率过快 108 号码内容空 110 禁止频繁单条发送 112 号码错误 113 定时时间格式不对 114 账号被锁，10分钟后登录 116 禁止接口发送 117 绑定IP不正确 120 系统升级 五、接收状态报告 5.1 主动获取状态 GET/POST操作格式： http://10086./api/st/?uid=用户pwd=MD532位密码 接口参数说明: 参数名 参数字段 参数说明 uid 用户用户http://10086./api/st/?uid=testpwd=b9887c5ebb23ebb294acab183ecf0769 响应返回值: 100