东联中讯三网合一短信接口详览与调用指南

需积分: 9 0 下载量 172 浏览量 更新于2024-09-14 收藏 123KB DOC 举报
东联中讯科技公司的三网合一短信接口文档详细介绍了如何通过HTTP接口进行短信发送、接收以及账户管理。该文档适用于该公司提供的1069三网合一短信服务,包括短信接口、短信平台和短信网关功能。 1. **HTTP接口调用**: 文档提供了两个不同的HTTP网关地址,一个支持UTF-8编码,另一个支持GBK编码,以适应不同的应用环境。在调用接口时,需要对参数值进行URL编码,并确保遵循特定的指令代码 (`X_ac`): - **参数说明**: - `X_sid`:会员编号,用于身份验证。 - `X_eid`:企业编号,标识企业账户。 - `X_uid`:会员账号,用于区分不同的用户。 - `X_pwd_md5`:采用MD5加密算法,包括密码和本地外网IP,且要求全小写。 - `X_ac`:操作指令,如发送普通短信(10)、发送长短信(12)、发送打包短信(13)、接收回复短信(20)、查询余额(30)、修改接口密码(50)和获取外网IP(100)。 - `X_gate_id`:固定值300,不可修改。 - `X_target_no`:接收手机号,支持多号码,最多100条。 - `X_memo`:短信内容,长度限制,如1.2.1发送普通短信(70字)或长短信(450字)。 2. **短信发送与接收**: - 发送短信:请求参数包括`X_ac=10`(普通短信)或`X_ac=12`(长短信),提供必要的企业代码、账号、密码等信息,以及接收者的手机号和短信内容。 - 接收回复短信:分为主动和被动接收。主动接收需定期调用接口(至少30秒一次),返回XML格式,包含用户回复的短信信息。 3. **返回值描述**: - 成功计费的短信数量:返回一个正整数表示成功发送的短信条数。 - 失败情况:返回小于或等于0的值,表明发送过程中存在问题。 这份文档为开发者提供了全面的指导,包括如何利用东联中讯科技的三网合一短信接口进行高效、安全的短信通信,以及如何处理接收的用户回复。对于任何想要集成此类服务到自己的应用中的开发者来说,理解和掌握这些接口参数和调用规则是至关重要的。