信通企业信息服务平台接口手册.docVIP

- .. - -可修编. 一信通企业信息效劳平台 接口手册 产品名称 一信通企业信息效劳平台接口手册 版本编号 2.1.2 文档编号 发布者 发布日期 2021-11-28 目录 TOC \o 1-3 \h \z \u 一信通企业信息效劳平台 1 1.概述 3 1.1编制目的 3 1.2容概述 3 1.3名称解释 3 1.4参考文献 3 2.短信 4 2.1 接口 4 2.1.1消息协议 4 2.1.2发送短信 4 2.1.3回执接口 6 2.1.4剩余短信条数查询 6 2.1.5上行回复容查询接口 7 2.1.6上行回复容确认接口 8 2.2Webservice接口 8 2.2.1消息协议 8 2.2.2发送短信 8 2.2.3回执接口 10 2.2.4上行回复容查询接口 10 2.2.5上行回复容确认接口 11 2.2.6容审核 12 修改历史 日期 版本 作者 修改容 评审号 更改请求号 概述 编制目的 该接口文档手册编写在于描述一信通企业信息效劳平台UMS〔以下简称UMS〕具体的接口协议，供第三方系统能够顺利接入一信通短信网关。 容概述 本规主要讲了第三方系统接入短信通系统的协议要求，协议三大状态和协议指令的格式和响应信息。 名称解释 缩略语 英文全名 中文全名 UMS Unified Message Service 一信通 SMS Short Messaging Service 短消息效劳 API Application Proframming Interface 应用程序编程接口 MO Message Original 消息上行 MT Message Terminal 消息下行 SP Service Provider 效劳提供商 CP Content Provider 容提供商 参考文献 短信 接口 消息协议 接口地址：ums.zj165.:8888/sms/Api/ 通过接口提交参数时, 参数容必须为GB2312 编码, 且经过url编码后的容。 例如:“您好〞的url编码为“%C4%FA%BA%C3〞 接口返回的容是一些键值对的字符串集合，形式为:“k1=v1k2=v2k3=v3…〞 返回容中的键值显示为url编码形式, 经过url解码后的键值是GB2312编码的字符串。 例如: 返回容“result=0description=%B7%A2%CB%CD%B3%C9%B9%A6faillist=〞表示的实际容为“result=0description=发送成功faillist=〞 发送短信 功能描述：短信发送 调用格式： 对ums.zj165.:8888/sms/Api/Send.do进展post 返回格式: result=description=错误描述faillist=失败列表 post参数说明： 类别 参数名称 类型 说明 输入 SpCode string 企业编号 输入 LoginName string 用户名称 输入 Password string 用户密码 输入 MessageContent string 短信容, 最大700个字符 输入 UserNumber string 手机(多个用〞,〞分隔)，最多1000个 输入 SerialNumber string 流水号，20位数字，唯一 输入 ScheduleTime string 预约发送时间，格式:yyyyMMddhhmmss,如‘101’，立即发送请填空 输入 f string 提交时检测方式 1 提交中有效的仍正常发出短信，无效的在返回参数faillist中列出 不为1 或该参数不存在 提交中只要有无效的，那么所有的都不发出短信，所有的在返回参数faillist中列出 返回值： 返回值 错误描述 0 发送短信成功 1 提交参数不能为空 2 账号无效或未开户 3 账号密码错误, 4 预约发送时间无效 5 IP不合法, 6 中含有无效或不在规定的号段, 7 容中含有非法关键字, 8 容长度超过上限，最大402字符 9 承受过多，最大1000 10 黑用户 11 提交速度太快 12 您尚未订购[普通短信业务]，暂不能发送该类信息 13 您的[普通短信业务]剩余数量发送缺乏，暂不能发送该类信息 14 流水号格式不正确 15 流水号重复 16 超出发送上限〔操作员当日发送上限〕 17 余额缺乏 18 扣费不成功 20 系统错误 21 您只能发送联通的手机，本次发送的手机中包含了非联通的手机 22 您只能发送移动的手机，本次发送的手机中包含了