易信通平臺接口手册(电信用户).docxVIP

EMS平台接口手册产品名称EMS平台发布日期2013/7/20目 录1、引言31.1.目的31.2.修改历史记录31.3.名称解释32、短信42.1.http接口42.1.1.短信发送42.1.2.短信接收52.1.3.查询状态报告62.1.4.查询余额82.1.5.查询关键字92.2.WebService接口102.2.1.短信发送102.2.2.短信接收112.2.3.查询状态报告132.2.4.查询余额142.2.5.查询关键字15附录：公共错误代码定义16引言目的该接口手册编写目的在于描述企业信息系统（以下简称EMS）具体的接口协议，供接口用户进行接口的对接开发。修改历史记录版 本修改人日 期描 述V陈林2013-07-20创建文档。V陈林2013-11-19增加2.1.2及2.2.2一对一批量发送，同时增加两个错误代码值13，14V陈林2013-12-10增加2.3 节 DB接口V陈林2014-03-09增加错误代码15 签名未报备V陈林2014-04-14DB接口升级：增加监控，路由功能V陈林2014-04-28增加错误代码16 单位时间内该号码最大发送限制V陈林2014-05-20增加错误代码17 校验签名时签名长度及格式非法名称解释缩略语英文全名中文全名EMSEnterprise Message System企业信息系统SMSShort Messaging Service短消息服务MMSMultimedia Message Service多媒体消息APIApplication Programming Interface应用程序编程接口MOMessage Original消息上行MTMessage Terminal消息下行SPService Provider服务提供商CPContent Provider内容提供商短信http接口短信发送功能：发送短信地址： 2/sendSMS.action备注：建议采用post方法提交请求。请求参数定义如下： 参数名称描述字段值enterpriseID企业ID由系统开户设置,系统分配。不允许为空loginName登录名String，不允许为空。系统开户设置登录名 password登录密码String，不可以为空。密码采用32位小写MD5加密.smsId消息idString，可以为空。消息id是这个包唯一标识，若为空则系统随机分配一个唯一标识值。若不为空，由用户自己设置一个唯一标识值。该值做为应答及状态报告中的消息id一一对应。 subPort扩展端口String,可以为空。空表示不再扩展，若扩展必须是数字如：00，01，02…若扩展输入00则手机收到端口号为：10657*****00(备注：扩展必须此帐户配置通道支持)content短信内容String 不可以为空，内容采用utf-8编码mobiles接收手机号码String，不可以为空。支持移动，联通，电信混合提交;多个号码中间采用半角逗号分隔,每个包最大支持100个号码。例13000000000endTime定时发送时间String,可以为空。为空表示立即发送，定时时间格式为：yyyy-MM-dd HH:mm:ss返回结果以xml形式返回，详细参数及示例如下：参数名称描述Response根节点Result提交返回结果状态，详细状态码详见附录： 公共错误代码定义SmsId消息id,用于配对状态报告,每个包提交返回消息id唯一。若发送时设置消息id，则返回是设置消息id值。失败返回结果样例：?xml version=1.0 encoding=UTF-8?ResponseResult1/Result/Response成功返回结果样例：?xml version=1.0 encoding=UTF-8?ResponseResult0/ResultSmsId10201201200/SmsId/Response一对一批量发送功能：发送短信地址： 2/batchSingleSendSMS.action备注：建议采用post方法提交请求。请求参数定义如下： 参数名称描述字段值enterpriseID企业ID由系统开户设置,系统分配。不允许为空loginName登录名String，不允许为空。系统开户设置登录名 password登录密码String，不可以为空。密码采用32位小写MD5加密.batchSmsId消息id串String，可以为空。消息id串每一个号码即一条短信对应一个id值，该值唯一区分每一个短信。同一批次提交多个信息消息id值中间采用半角逗号分隔，若为空则系统随机分配一批消息id值，与号码串一一对应。若不为空，由用户自己设置一批消息id值，中间用半角逗号分隔，注意每一个