HTTP短信接口文档.doc

短信接口说明书HTTP短信接口文档版本：version4.1 最新修改时间:2016-12-27Ip:目录1.1 发送短信 31.1.1 发送短信格式 31.1.2 发送短信参数说明 31.1.3 发送短信响应包 31.1.4 发送短信响应包参数说明： 31.2 接收短信状态报告 41.2.1 接收状态报告格式 41.2.2 接收状态报告参数说明 41.2.3 接收状态报告响应包 41.2.4 接收状态报告响应包参数说明 51.3 接收短信 51.3.1 接收短信格式 51.3.2 接收短信参数说明 51.3.3 接收短信响应包 51.3.4 接收短信响应包参数说明 61.4 查询余额 61.4.1 查询余额格式 61.4.2 查询余额参数说明： 61.4.3 查询余额响应包 61.4.4 查询余额响应包参数说明 6 1.1 发送短信1.1.1 发送短信格式（HTTP GET或者HTTP POST）http://ip:18002/send.do?ua=xxx&pw=xxx&mb=13900000001&ms=A&ex=01&tm=xxx&dm=xxxx注意：接入之后最好向管理员申请ip地址绑定，这样能防止被恶意尝试造成账号泄露或被锁定（密码连续错误10次将被锁定）1.1.2 发送短信参数说明ua：用户名pw：密码 密码值为md5（pw+tm），tm设置为当前时间，与标准时间误差不能超过30分钟。

注：中间的+号在实际赋值时不要填写， tm格式yyyymmddhhmiss共14位）mb：目的号，多条请用英文逗号隔开，最多10000个号码ms：发送内容，如果含有空格，百分数等特殊内容，请用utf8方式进行编码，最多500个文字（1个英文或数字也算1个文字）ex：发送扩展号，对于可扩展的通道，可以根据需要任意扩展，但发送出去总长度不会超过20位，可选参数tm：当前时间，格式：yyyymmddhhmissdm：定时时间（可以为空），格式：yyyymmddhhmiss1.1.3 发送短信响应包格式举例：0,1112090856000110意义：返回值,消息编号1.1.4 发送短信响应包参数说明：注意：A、 响应包里没有账号密码是否正确、是否余额不足、账号状态是否正确的提醒，请通过余额查询接口来做相应检测，如果发生这种情况，管理员会第一时间通知您；B、 同样的内容对同一个号码发多条，系统会自动去重，这样做是为了避免因重复发送造成的投诉；返回值含义0发送成功-1ua或密码为空-2下发号码为空-3下发内容为空-4内容超长-5下发号码超长-6ua或密码不正确-7余额不足-8IP地址鉴权不对-9协议类型不对-99系统异常1.2 接收短信状态报告1.2.1 接收状态报告格式（多条POST方式，每次最多100条记录） 地址：rpturl（接入方提供，可以在管理后台自助配置）格式：rpturl?data=msgid,mobile,stat|msgid,mobile,stat|msgid,mobile,stat举例：rpturl?data=05201617404137,13900000001,DELIVRD|05220128211118,13900000002,DELIVRD|05220141501133,13900000003,MK:00101.2.2 接收状态报告参数说明rpturl：由接入方提供的接收状态报告的地址，通道方把状态报告（消息编号、状态、号码，特服号）的数据传给此地址id：消息IDst：短信状态报告，stat=DELIVRD表示用户成功接收短信。

mb：号码1.2.3 接收状态报告响应包响应“0”即可1.3 接收短信1.3.1 接收短信格式（单条POST方式，每次1条记录）地址：mourl（接入方提供，可以在管理后台自助配置）格式：mourl?mb=xxx&sc=xxx&ms=xxx举例：mourl?mb=13900000001&sc=10690001&ms=你好，测试1.3.2 接收短信参数说明mourl：由合作方提供的接收上行的地址，通道方把用户回复的短信数据（号、特服号、内容）传给此地址mb：号sc：特服号ms：内容（utf8编码）1.3.3 接收短信响应包响应 0 即可1.4 查询余额1.4.1 查询余额格式http://ip:18005/balance.do?ua=xxx&pw=xxx注意：接入之后最好申请ip地址绑定，这样能防止被恶意尝试造成账号泄露或被锁1.4.2 查询余额参数说明ua：用户名；pw：密码；1.4.3 查询余额响应包直接返回余额数字，例如：169082ua或密码不正确：02。