华兴软通短信平台HTTP接口(2.0版)用户手册.doc

华兴软通短信平台HTTP接口(2.0)版用户手册1. 编码说明编码为UTF-82. HTTP接口（用户部分）2.1. 用户注册2.1.1. 用户注册的Http接口地址：地址：/sdkhttp/reg.aspx2.1.2. 参数说明：参数描 述reg注册号（由华兴软通指定），不可为空pwd密码（由华兴软通指定），不可为空uname联系人姓名，不可为空mobile手机，不可为空phone座机，不可为空fax传真，不可为空email电子邮件，不可为空postcode邮编，不可为空company公司名称，不可为空address公司地址，不可为空2.1.3. 调用示例/sdkhttp/reg.aspx?reg=&pwd=&uname=&mobile=&phone=&fax=&email=&postcode=&company=&address=2.1.4. 调用成功返回值result=0&message=注册成功字段含义：result：结果码，0表示成功，其他表示失败message：结果码解释错误代码参见附录2.2. 查询余额操作的Http接口说明:2.2.1. 查询余额的Http接口地址:地址：/sdkhttp/getbalance.aspx2.2.2. 参数说明：参数描 述reg注册号（由华兴软通指定），不可为空pwd密码（由华兴软通指定），不可为空2.2.3. 调用示例/sdkhttp/getbalance.aspx?reg=&pwd=2.2.4. 调用成功返回值result=0&balance=XXX字段含义：result：结果码，0表示成功，其他表示失败message：结果码解释balance参数后面跟着余额，错误代码参见附录2.3. 注销操作的Http接口说明(如果无必要，可以不实现)2.3.1. 发送即时短信的Http接口地址:地址：/sdkhttp/unreg.aspx2.3.2. 参数说明：参数描 述reg注册号（由华兴软通指定），不可为空pwd密码（由华兴软通指定），不可为空2.3.3. 调用示例/sdkhttp/unreg.aspx?reg=&pwd=2.3.4. 调用成功返回值result=0&message=注册号XXX注销成功字段含义：result：结果码，0表示成功，其他表示失败message：结果码解释错误代码参见附录2.4. 修改密码的Http接口说明:2.4.1. 修改密码的Http接口地址:地址：/sdkhttp/uptpwd.aspx2.4.2. 参数说明：参数描 述reg注册号（由华兴软通指定），不可为空pwd旧密码（由华兴软通指定），不可为空newpwd新密码，不可为空2.4.3. 调用示例/sdkhttp/uptpwd.aspx?reg=&pwd=&newpwd=2.4.4. 调用成功返回值result=0&message=密码修改成功字段含义：result：结果码，0表示成功，其他表示失败message：结果码解释错误代码参见附录2.5. 查询发送报告:2.5.1. 查询发送报告的Http接口地址:地址：/sdkhttp/getmtreport.aspx2.5.2. 参数说明：参数描 述reg注册号（由华兴软通指定），不可为空pwd密码（由华兴软通指定），不可为空2.5.3. 调用示例/sdkhttp/getmtreport.aspx?reg=&pwd=2.5.4. 调用成功返回值result=0&message=查询发送报告成功&total=xxx&waitnum=xxx&sendingnum=xxx&sucessnum=xxx&failnum=xxx字段含义：result：结果码，0表示成功，其他表示失败message：结果码解释total：当天提交总数waitnum：等待发送数量）sendingnum：正在发送数量sucessnum：成功数量failnum：失败数量错误代码参见附录2.6. 发送即时短信2.6.1. 发送即时短信的Http接口地址:地址：/sdkhttp/sendsms.aspx2.6.2. 参数说明：参数描 述reg注册号（由华兴软通指定），不可为空pwd密码（由华兴软通指定），不可为空sourceadd子通道号（最长10位，可为空）phone手机号码（最多1000个），多个用英文逗号(,)隔开，不可为空content短信内容（UTF-8编码）（最多600个字符，字母、标点都算字符），不可为空2.6.3. 调用示例/sdkhttp/sendsms.aspx?reg=&pwd=&sourceadd=&phone=&content=/sdkhttp/sendsms.aspx?reg=101100-AZXY-WEB-A00001&pwd=AS8723KJ&sourceadd=&phone13001930021&content=test2.6.4. 调用成功返回值result=0&message=短信发送成功&smsid=字段含义：result：结果码，0表示成功，其他表示失败message：结果码解释smsid：短信包ID错误代码参见附录2.7. 发送定时短信2.7.1. 发送定时短信的Http接口地址:地址：/sdkhttp/sendschsms.aspx2.7.2. 参数说明：参数描 述reg注册号（由华兴软通指定），不可为空pwd密码（由华兴软通指定），不可为空sourceadd子通道号（最长10位，可为空）tim定时时间，格式为：yyyy-mm-dd HH:MM:SS，不可为空phone手机号码（最多1000个），多个用英文逗号(,)隔开，不可为空content短信内容（UTF-8编码）（最多600个字符，字母、标点都算字符），不可为空2.7.3. 调用示例/sdkhttp/sendschsms.aspx?reg=&pwd=&sourceadd=&tim=&phone=&content=2.7.4. 调用成功返回值result=0&message=短信发送成功&smsid=字段含义：result：结果码，0表示成功，其他表示失败message：结果码解释smsid：短信包ID错误代码参见附录2.8. 上行短信推送2.8.1. 上行短信推送的Http接口地址（由用户提供）例如：http:/localhost:4772/sdkhttp/TestRecvMo.aspx?2.8.2. 参数说明：参数描 述phone手机号码source扩展码motime手机上行短信时间，格式为：yyyy-MM-dd HH:mm:sscontent短信内容2.8.3. 推送示例http:/localhost:4772/sdkhttp/TestRecvMo.aspx?&phone=xxxxx&source=xxxxx&motime=xxxxx&content=xxxxx2.8.4. 用户接收上行短信返回值成功返回：0失败返回：-12.8.5. 接收失败处理用户接收失败，不再继续推送，但保存在服务器一个月。用户可以待自己服务器正常后下，要求华兴软通客服重新推送或者手工提取。3. 附录错误码错误码含义0成功500程序异常-1参数格式错误-2注册号或者密码错误-3密码连续