三网合一短信接口文档.doc

PAGE8 / NUMPAGES8 三网合一短信接口文档v2.0 一、HTTP接口调用说明(支持POST和GET) HTTP网关地址: UTF8编码网关 HYPERLINK :6000/utf8/web_api/SendSMS_V2.aspx 55:6000/utf8/web_api/SendSMS_V2.aspxGBK 编码网关 HYPERLINK :6000/gbk/web_api/SendSMS_V2.aspx 55:6000/gbk/web_api/SendSMS_V2.aspx 提示:HTTP调用URL接口时, 参数值必须URL编码后再调用 参数说明 序号参数名描述1X_sid会员编号2X_eid企业编号3X_uid会员帐号4X_pwd_md5MD5（MD5（密码）+本机外网ip）英文字母全是小写5X_ac操作指令 10 发送普通短信70字 12 发送长短信450字 13发送打包短信不同内容20 接收回复短信 30查询账户余额 50修改接口密码 100 获取外网IP，用于生成x_pwd_md56X_gate_id300固定不能修改7X_target_no接口短信手机号，多个号码用逗号分开，最多支持100条每次8X_memo短信发送内容，最多450字符,必须url编码 1.2发送短信 1.2.1发送普通短信（70字） 请求参数 X_ac=10x_eid=企业代码x_uid=会员帐号x_pwd_md5=访问密码x_gate_id=300x_target_no=接收手机号x_memo=发送短信内容 1.2.1发送长短信(450字) 请求参数 X_ac=12x_eid=企业代码x_uid=会员帐号x_pwd_md5=访问密码x_gate_id=300x_target_no=接收手机号x_memo=发送短信内容 返回值描述 类型值int0(大于0) 成功计费条数=0 (小于等于0) 失败 2.接收回复短信(分主动和被动两种接收) 2.1主动接收回复短信(最小调用间隔30秒一次) 请求参数 X_ac=20x_eid=企业代码x_uid=会员帐号x_pwd_md5=访问密码x_gate_id=300 返回XML格式（返回2条用户回复的短信） ReadSMS Item Id1/Id(序列号可以忽略) SId1001/SId（会员编号,如果有多个帐号情况下） SenderNSenderNo(回复手机号) MsgContent能??到我回复的测试短信么？/MsgContent（回复内容） SendTime2009-11-21 16:54:14/SendTime(回复时间) SP_PID10655059052084/SP_PID（回复到网关的号码） subNo 1200 subNo / (用户扩展码) /Item  HYPERLINK /jiekou.aspx  Item Id2/Id SId1002/SId SenderNSenderNo MsgContent这是第二条测试短信!/MsgContent SendTime2009-11-21 16:13:37/SendTime SP_PID10655059052084/SP_PID subNo101 subNo / !--客户扩展子号码-- /Item /ReadSMS 2.2被动接收回复短信（如果有新回复短信，我们会主动以PUSH方式发送给用户指定的页面） 此方式采用http+xml+post技术，需要用户提供一个接收短信页面地址 以下是post+xml时的样本： ReadSMS !--收到短信开始--Item !--如果有多条循环此节-- id1/id!-可忽略--SId1001/SId !-- 会员编号,企业子帐号区分不同会员上行 --SenderNSenderNo !--回复者号码--MsgContent这个是被动回复过来的，能收到么？/MsgContent !--回复短信内容--SendTime2008-03-14 23:07:39/SendTime !--回复时间--SP_PID1065810889988/SP_PID !-回复到SP号的号码--subNo101/subNo !--客户扩展子号码--/Item /ReadSMS 3.查询短信余额 请求参数 X_ac=30x_eid=企业代码x_uid=会员帐号x_pwd_md5=访问密码x_gate_id=300 返回值 Sms:10000,mms:5000 描述 Sm