北信通国内短信接口文档.docVIP

HTTP短信接口文档 版本：version3.1 必威体育精装版修改时间:2016-06-18 服务器IP (server)：5  目录 1.1 发送短信 3 1.1.1 发送短信格式 3 1.1.2 发送短信参数说明 3 1.1.3 发送短信响应包 3 1.1.4 发送短信响应包参数说明： 3 1.2 接收短信状态报告 4 1.2.1 接收状态报告格式 4 1.2.2 接收状态报告参数说明 4 1.2.3 接收状态报告响应包 4 1.2.4 接收状态报告响应包参数说明 5 1.3 接收短信 5 1.3.1 接收短信格式 5 1.3.2 接收短信参数说明 5 1.3.3 接收短信响应包 5 1.3.4 接收短信响应包参数说明 6 1.4 查询余额 6 1.4.1 查询余额格式 6 1.4.2 查询余额参数说明： 6 1.4.3 查询余额响应包 6 1.4.4 查询余额响应包参数说明 6 发送短信 发送短信格式（HTTP GET或者HTTP POST） http:// server:18002/send.do?ua=xxxpw=xxxmbnter=1ms=Aex=01tm=xxx 注意：接入之后最好向管理员申请ip地址绑定，这样能防止被恶意尝试造成账号泄露或被锁定 发送短信参数说明 ua：用户名 pw：密码 第一种方式：用原密码 第二种方式：用md5（pw+tm），如果无需定时发送，将tm设置为比当前时间小、且在30分钟之内的随机时间即可。注意：中间的“+”号在实际赋值时不要填写。 mb：目的手机号，号码格式为“国家代码+手机号”。例如发送一个巴西手机号，巴西国家代码为0055，手机号为11943460346，那么“mb=005511943460346”。多个号码请用英文逗号隔开，最多10000个号码。 ms：发送内容，如果含有空格，百分数等特殊内容，请用gbk编码进行传送，最多300个文字（1个英文或数字也算1个文字） ex：发送扩展号，对于可扩展的通道，可以根据需要任意扩展，但发送出去总长度不会超过20位，可选参数。 tm：定时时间，格式：yyyy-mm-dd hh:mi:ss 系统默认合包，如果不想合包，请咨询客服人员。 发送短信响应包格式 举例： 0,11120908560001 意义： 返回值,消息编号 发送短信响应包参数说明： 注意： 响应包里没有账号密码是否正确、是否余额不足、账号状态是否正确的提醒，请通过余额查询接口来做相应检测，如果发生这种情况，管理员会第一时间通知您； 同样的内容对同一个号码发多条，系统会自动去重，这样做是为了避免因重复发送造成的投诉； 返回值 含义 0 发送成功 -1 帐号或密码为空 -2 下发号码为空 -3 下发内容为空 -4 内容超长 -5 下发号码超长 -6 参数错误 -8 Ip鉴权失败 -99 系统异常 接收短信状态报告 接收状态报告格式 方式一，单条GET： rpturl?id=xxxst=1mb方式二，单条POST： 地址：rpturl post数据为：id=xxxst=1mb方法三：多条POST(不带参数)： 地址：rpturl (格式：msgid,mobile,stat|msgid,mobile,stat|msgid,mobile,stat ，多条记录用|分开) 05201617404137DELIVRD|05220128211118DELIVRD|05220141501133MK:0010 方法四：多条POST（带参数） 地址：rpturl (格式：data=msgid,mobile,stat|msgid,mobile,stat|msgid,mobile,stat ，多条记录用|分开) data=05201617404137DELIVRD|05220128211118DELIVRD|05220141501133MK:0010 方法五：取状态 http://server:18008/getrpt?ua=abcpw=123456ac=rpt 取出来的格式(最多20组)：msgid,mobile,stat|msgid,mobile,stat|msgid,mobile,stat 例如：05201617404137DELIVRD|052201