易信通平台接口基础手册电信用户.docxVIP

EMS平台接口手册 产品名称 EMS平台 公布日期 20XX/7/20 目 录 TOC \o 1-3 \h \z 1、 引言 3 1.1. 目标 3 1.2. 修改历史统计 3 1.3. 名称解释 3 2、 短信 4 2.1. http接口 4 2.1.1. 短信发送 4 2.1.2. 短信接收 5 2.1.3. 查询状态汇报 6 2.1.4. 查询余额 8 2.1.5. 查询关键字 9 2.2. WebService接口 10 2.2.1. 短信发送 10 2.2.2. 短信接收 11 2.2.3. 查询状态汇报 13 2.2.4. 查询余额 14 2.2.5. 查询关键字 15 附录：公共错误代码定义 16  引言 目标 该接口手册编写目标在于描述企业信息系统（以下简称EMS）具体接口协议，供接口用户进行接口对接开发。 修改历史统计 版 本 修改人 日 期 描 述 V 陈林 20XX-07-20 创建文档。 V 陈林 20XX-11-19 增加2.1.2及2.2.2一对一批量发送，同时增加两个错误代码值13，14 V 陈林 20XX-12-10 增加2.3 节 DB接口 V 陈林 20XX-03-09 增加错误代码15 署名未报备 V 陈林 20XX-04-14 DB接口升级：增加监控，路由功效 V 陈林 20XX-04-28 增加错误代码16 单位时间内该号码最大发送限制 V 陈林 20XX-05-20 增加错误代码17 校验署名时署名长度及格式非法 名称解释 缩略语 英文全名 汉字全名 EMS Enterprise Message System 企业信息系统 SMS Short Messaging Service 短消息服务 MMS Multimedia Message Service 多媒体消息 API Application Programming Interface 应用程序编程接口 MO Message Original 消息上行 MT Message Terminal 消息下行 SP Service Provider 服务提供商 CP Content Provider 内容提供商 短信 http接口 短信发送 功效：发送短信 地址： 备注：提议采取post方法提交请求。 请求参数定义以下： 参数名称 描述 字段值 enterpriseID 企业ID 由系统开户设置,系统分配。不许可为空 loginName 登录名 String，不许可为空。系统开户设置登录名 password 登录密码 String，不能够为空。密码采取32位小写MD5加密. smsId 消息id String，能够为空。消息id是这个包唯一标识，若为空则系统随机分配一个唯一标识值。若不为空，由用户自己设置一个唯一标识值。该值做为应答及状态汇报中消息id一一对应。 subPort 扩展端口 String,能够为空。空表示不再扩展，若扩展必需是数字如：00，01，02… 若扩展输入00则手机收到端口号为：10657*****00 (备注：扩展必需此帐户配置通道支持) content 短信内容 String 不能够为空，内容采取utf-8编码 mobiles 接收手机号码 String，不能够为空。支持移动，联通，电信混合提交;多个号码中间采取半角逗号分隔,每个包最大支持100个号码。例： ,, sendTime 定时发送时间 String,能够为空。为空表示立即发送，定时时间格式为： yyyy-MM-dd HH:mm:ss 返回结果以xml形式返回，具体参数及示例以下： 参数名称 描述 Response 根节点 Result 提交返回结果状态， 具体状态码详见附录： 公共错误代码定义 SmsId 消息id,用于配对状态汇报,每个包提交返回消息id唯一。若发送时设置消息id，则返回是设置消息id值。 失败返回结果样例： ?xml version=1.0 encoding=UTF-8? Response Result1/Result /Response 成功返回结果样例： ?xml version=1.0 encoding=UTF-8? Response Result0/Result SmsId1020XX01200/SmsId /Response 一对一批量发送 功效：发送短信 地址： 备注：提议采取post方法提交请求。 请求参数定义以下： 参数名称 描述 字段值 enterpriseID 企业ID 由系统开户设置,系统分配。不许可为空 loginName 登录名 String，不许可为空。