14 短信提交响应定义.doc

HTTP接口参数  目录 HTTP接口参数 1 1 HTTP提交短信（MT） 3 1.1 提交方式 3 1.2 提交参数定义 3 1.3 msgid 3 1.4 短信提交响应定义 4 1.5 提交流速控制 4 1.6 提交响应代码 4 1.7 常见状态报告列表 5  HTTP提交短信（MT） 客户提交短信到群发平台 提交方式 用户提交方式为HTTP协议POST请求 提交参数定义 服务映射名：HttpSendSM 帐号（account），即用户账号 密码（pswd），即用户密码 手机号（mobile），最多200个合法的手机号码，号码间用英文逗号分隔。 短信内容（msg），短信内容长度不能超过585个字符。使用URL方式编码为UTF-8格式。短信内容超过70个字符（企信通是66个字符）时，会被拆分成多条，然后以长短信的格式发送，每条短信最大长度67个字符（企信通是66个字符）。 是否需要状态报告（needstatus），取值true或false 例子： http://localhost/msg/HttpSendSM?account=111111pswd=123456mobile13800138000msg=testneedstatus=true 57/msg/HttpSendSM?account=jhliu88pswd=buzhidao001()mobile13800138000,14700210021,14500210021sg=testneedstatus=true 注：68这个地址按照系统实际部署的IP地址填写。如果部署的WEB服务不是使用的80端口，还需要在地址后加上端口号。 注：本接口提交短信不审核。 msgid 短消息标志，由服务器生成，在用户提交短信后返回给客户端 一次提交只会返回一个msgid 短信提交响应定义 提交成功的短信，返回一个提交响应，包含响应时间、响应状态、msgid。 提交失败的短信，返回一个提交响应，包含响应时间、响应状态 字段： resptime，响应消息产生的时间，格式为yyyyMMddHHmmss respstatus, 响应值，具体含义见后面的列表 msgids，拆分后每条消息的msgid 消息格式（每行以换行符(0x0a,即\n)分割） resptime,respstatus msgid 例如： 2011072516041240,0 1234567890100 提交流速控制 用户提交短信不进行流速控制，平台接收后缓存到文件中，然后以固定的速度发送到短信网关 提交响应代码 代码 说明 0 提交成功 101 无此用户 102 密码错 103 提交过快（提交速度超过流速限制） 104 系统忙 105 敏感短信（短信内容包含敏感词） 106 消息长度错（585或=0） 107 包含错误的手机号码 108 手机号码个数错（200或=0） 109 无发送额度（该用户可用短信数已使用完） 110 不在发送时间内 111 参数有问题 常见状态报告列表 状态值(字符串) 说明 DELIVRD 短消息转发成功 EXPIRED 短消息超过有效期 UNDELIV 短消息是不可转发的 UNKNOWN 未知短消息状态 REJECTD 短消息被拒绝 DTBLACK 目的号码是黑名单号码 ERR:104 系统忙 其他 网关内部状态