《三网合一短信接口文档》由会员分享，可在线阅读，更多相关《三网合一短信接口文档（8页珍藏版）》请在金锄头文库上搜索。
1、 1 / 8 三网合一短信接口文档v2.0 一、HTTP接口调用说明(支持POST和GET) HTTP网关地址: UTF8编码网关 http:/114.113.145.155:6000/utf8/web_api/SendSMS_V2.aspx GBK 编码网关 http:/114.113.145.155:6000/gbk/web_api/SendSMS_V2.aspx 提示:HTTP调用URL接口时, 参数值必须URL编码后再调用 1.1 参数说明 序号 参数名 描述 1 X_sid 会员编号 2 X_eid 企业编号 3 X_uid 会员帐号 4 X_pwd_md5 MD5（MD5（密码）+
2、本机外网ip）英文字母全 是小写 5 X_ac 操作指令 10 发送普通短信70字 12 发送长短信450字 13发送打包短信不同内容 20 接收回复短信 30查询账户余额 50修改接口密码 100 获取外网IP，用于生成x_pwd_md5 6 X_gate_id 300固定不能修改 7 X_target_no 接口短信手机号，多个号码用逗号分开，最多 支持100条每次 8 X_memo 短信发送内容，最多450字符,必须url编码 1.2发送短信 1.2.1发送普通短信（70字）请求参数 X_ac=10&x_eid=企业代码&x_uid=会员帐号&x_pwd_md5=访问密码&x_gate_
3、id=300&x_target_no=接收 手机号&x_memo=发送短信内容 1.2.1发送长短信(450字)请求参数 2 / 8 X_ac=12&x_eid=企业代码&x_uid=会员帐号&x_pwd_md5=访问密码&x_gate_id=300&x_target_no=接收 手机号&x_memo=发送短信内容 返回值描述 类型 值 0(大于0) 成功计费条数 int1(序列号可以忽略) 1001（会员编号,如果有多个帐号情况下） 13020930000(回复手机号) 能收到我回复的测试短信么？（回复内容） 2009-11-21 16:54:14(回复时间) 10655059052084（
4、回复到网关的号码） 1200 (用户扩展码)2 1002 13020930000 这是第二条测试短信! 2009-11-21 16:13:37 10655059052084 101 2.2被动接收回复短信（如果有新回复短信，我们会主动以PUSH方式发送给用户指定的页面）此方式采用http+xml+post技术，需要用户提供一个接收短信页面地址以下是post+xml时的样本：3 / 8 1 1001 13405886058 这个是被动回复过来的，能收到么？ 2008-03-14 23:07:39 1065810889988 101 3.查询短信余额 请求参数 X_ac=30&x_eid=企业代码
5、&x_uid=会员帐号&x_pwd_md5=访问密码&x_gate_id=300 返回值 Sms:10000,mms:5000 描述 Sms:指短信剩余条数，mms:指彩信剩余条数 4.修改接口密码 请求参数 X_ac=50&x_eid=企业代码&x_uid=会员帐号&x_pwd_md5=访问密码&x_new_pwd=接口新密码 MD5&x_gate_id=300 返回值1 修改新密码成功，否则失败。 5.打包提交不同内容短信(最多支持100个包),必须使用POST方式 请求参数(只接受POST方式) X_ac=13&x_eid=企业代码&x_uid=会员帐号&x_pwd_md5=访问密码&x
6、_gate_id=300&x_memo=xml格式 x_memo格式如下编号 (如果失败，会输出这个编号,保证此包里不要重复) 用户手机号码1长短信，0普通短信,(超过70字自动设置1) 扩展码 4 / 8返回值(Int数字类型)大于0成功，否则失败 6.获取公网ip用于验证访问密码，x_pwd_md5需要用到这个值 请求参数 X_ac=100 返回值 120.2.2.100 HTTP返回值参对表 编号 值 说明 1 大于0 发送成功,此次发送成功条数 2 -1 参数无效 3 -2 通道不存在或者当前业务不支持此通道 4 -3 定时格式错误 5 -4 接收号码无效 6 -5 提交号码个数超过上
7、限,每个通道都有批量提交的上限.详细值请参 考通道说明 7 -6 发送短信内容长度不符合要求,参考通道要求长度 8 -7 当前账户余额不足 9 -8 网关发送短信时出现异常 10 -9 用户或者密码没输入 11 -10 企业ID或者会员账号不存在 12 -11 密码错误 13 -12 账户锁定 14 -13 网关状态关闭 15 -14 验证用户时执行异常 16 -15 网关初始化失败 17 -16 当前IP已被系统屏蔽,可能是与您设置的接入IP不同或者是失败次 数太多 18 -17 发送异常 5 / 8 19 -18 账号未审核 20 -19 当前时间不允许此通道工作，主要对群发通道限制 21
8、 -20 传输密钥未设置，请登陆平台设置 22 -21 提取密钥异常 23 -22 签名验证失败 24 -23 发现屏蔽关键字 25 -100到- 199 运营商返回失败代码 二、WebService调用方式 WS网关地址: Utf8网关 http:/114.113.145.155:6000/utf8/ws_api/WebSMS_V2.asmx GBK网关 http:/114.113.145.155:6000/gbk/ws_api/WebSMS_V2.asmx WebService服务函数目录 1.EditPWD 修改接口密码,平台登录密码不受影响 2.FastSend 快速发送短信,直接提交
9、到运营商,本站不存储任何数据.返回值:SendResult 自定义类 3.FastSendLongSMS 发送长短信,最多支持450字.按64字计费,本站不存储任何数据.返回值:SendResult 自定义类 4.GetBalance 查询账户剩余短信/彩信条数,返回值:sms:100,mms:100 当前余额,否则返回失败代码 5.GetUpSMS 客户主动读取上行短信,最小间隔30秒,返回多个Woxp_UpSMS上行类。每条上行信息生成一个类,没有 上行就返回NULL 6.SendXMLPack 打包发送短信，适合不同内容批量提交，以xml格式打包，上限100条.返回值:SendResul
10、t 公共参数调用描述 eid_pwd_gateId，该参数是字符串类型，由多个值拼成 6 / 8 所有函数都必须依赖这个参数来提供服务 参数格式 （ 会员编号-企业代码会员帐号MD5（MD5（接口密码）+登录IP）-通道号）各个参数用-分 开 参数例如 （1）会员编号：15 （2）企业代码：10001 （3）会员帐号：smsone （4）登录MD5: e10adc3949ba59abbe56e057f20f883e, MD5（MD5（接口密码）+登录IP） 登录IP可以由http:/114.113.145.155:6000/utf8/web_api/SendSMS_V2.aspx?x_ac=1
11、00获取 （5）通道号:300(这个是固定值) eid_pwd_gateId =15-10001-smsone-e10adc3949ba59abbe56e057f20f883e-300(注意分隔符-半角下输入) 1. 修改接口密码public int EditPWD(string eid_pwd_md5, string newPwd_md5)参数描述newPwd_md5,新接口密码MD5值（32 位）返回值1成功，否则失败. 2.发送普通短信70字public SendResult FastSend(string eid_pwd_gateId, string TargetNo, string
12、MsgContent, string SendTime, string strSubId) 参数描述 （1） TargetNo 发送手机号码，多个号码用逗号分开。最多支持100个号码 （2） MsgContent 发送短信内容，最多70个字符 （3） SendTime 定时发送时间，暂时为null,预留参数 （4） strSubId 扩展码，确认不同用户回复 返回值: SendResult自定义类stringint(是否成功由这个值确定，大于0成功其它值失败)stringintstringstringstring成功标识 RetCode值大于0代表发送成功，返回计费条数，否则就返回失败代码 7
13、 / 8 3.发送长短信450字 public SendResult FastSendLongSMS(string eid_pwd_gateId, string TargetNo, string MsgContent, string SendTime, string strSubId) 解释同【发送普通短信70字】一样，请参考FastSend上面说明. 4.查询账户余额 public string GetBalance(string eid_pwd_md5) 调用成功后返回值 Sms:1000,mms:1000 该帐号剩余短信1000条，彩信1000条 5.获取用户回复的短信 public W
14、oxp_UpSMS GetUpSMS(string eid_pwd_gateId) 返回值， 如果有回复短信返回Woxp_UpSMS数组集合.每个数组存储回复详细信息。否则为NULLWoxp_UpSMS 自定义类型int (上行编号，可以忽略)int (会员编号区分企业下面多个帐号)string (回复者的手机号)string (回复内容)string (回复时间)string (用户扩展码，区分哪个用户回复)string (回复网关号码)6.打包提交不同内容短信，最大支持100个包public SendResult SendXMLPack(string eid_pwd_gateId, string xml)本函数适合不同内容短信批量提交，返回值请参考FastSend函数返回值. 调用参数 xml格式编号 (如果失败，会输出这个编号,保证此包里不要重复) 用户手机号码1长短信，0普通短信,(超过70字自动设置1) 扩展码
