2022年中国移动通信有限公司政企客户分公司云MAS平台SDK接口.. 3.pdf
《2022年中国移动通信有限公司政企客户分公司云MAS平台SDK接口.. 3.pdf》由会员分享,可在线阅读,更多相关《2022年中国移动通信有限公司政企客户分公司云MAS平台SDK接口.. 3.pdf(10页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、. . 案卷号日期云 MAS 平台 SDK1.0.1(HTTP版)用户手册作者: 中国移动通信有限公司政企客户分公司完成日期:2015-12-7 签 收 人:签收日期:名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页,共 10 页 - - - - - - - - - . . 修改情况记录:版本号修改内容修改日期修改人1.0.0 草稿2015-12-7 汪植成1.0.1 签名错误或普通短信不允许使用模板短信的签名编码2016-04-20 汪植成名师资料总结 - - -精品资料欢迎
2、下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页,共 10 页 - - - - - - - - - . . 1云 MAS 平台 HTTP开发说明1.1简介云 MAS 平台 SDK HTTP 版接口说明文档1.2背景系统名称: 云 MAS 平台项目开发者 : 中国移动通信集团政企客户分公司1.3定义MT Message Terminal下行短信,即向手机终端发送短信MO Message Original 上行短信, 即手机用户向特服号码发送短信1.4环境服务器具有直连访问互联网的能力。并且提供HTTP Server
3、 接收比较报告,状态报告,上行短信。1.5云 MAS 平台与 HTTP 客户端数据交互流程HTTP 客户端云MAS服务端云MAS消息队列云MAS审核服务云MAS发送服务行业网关1.HTTP客户端提交短信至云MAS2.服务端提交消息至消息队列2.服务端提交消息至审核服务3.审核不通过4.返回审核结果数据结构见2.13.审核通过,消息队列提交客户封包至发送服务4.提交短信至行业网关5.返回短信回复6.返回短信回复8.返回短信回执9.返回短信回执7.返回短信回复数据结构见2.210. 返回短信回执数据结构见2.34.通知删除待发内容4. 返回审核状态HTTP 服务端2:返回状态码和后台生成的UUID
4、 ,名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页,共 10 页 - - - - - - - - - . . SDK收到的返回值说明:?“1. 返回提交状态” ,说明云 MAS 是否收到 HTTP提交的数据;数据还未提交行业网关;?“4. 返回审核结果” ,说明云MAS已经对提交内容进行了审核;数据还未提交行业网关;?“7. 返回短信回复” ,短信已经提交网关;?“10. 返回短信回执” ,短信已被网关下发;*因平台有流控设置,需要进行多条短信连续提交时,为保证提交速度和效率
5、,请按照“1. 返回提交状态”返回值判断是否提交下一条;2数据结构说明2.1 MT提交报告数据结构类型( TYPE ) :JSON 用途用于内部,跟踪短信状态,不能用于判断短信是否正确送达,短信是否送达以移动公司提供的账单为准。字段名数据类型说明type string 消息类型:1表示为提交报告,2 表示为状态报告,3 表示为用户上行短信 , 见附录 4.1(8) report_status string 状态报告的值,见附录4.1 mobiles string 手机号码 , 多个手机号码英文半角逗号分隔submit_date string 发送时间(格式为yyyy-mm-dd hi24:mi
6、:ss)receive_date string 接收时间(格式为yyyy-mm-dd hi24:mi:ss)error_code string 未发送成功错误编码,见附录4.1 msg_group string 消息批次号,由云 MAS 平台生成, 用于验证短信提交报告和状态报告的一致性2.2 MT状态报告数据结构类型( TYPE ) :JSON 用途保存状态报告接口函数返回的短信内容,不能用于判断短信是否正确送达,短信是否送达以移动公司提供的账单为准。字段名数据类型说明名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整
7、理 - - - - - - - 第 4 页,共 10 页 - - - - - - - - - . . type string 消息类型:1表示为提交报告,2 表示为状态报告,3 表示为用户上行短信report_status string 状态报告的值,参见真实网关状态报告值mobile string 手机号码,每次返回单个号码submit_date string YYMMDDHHMM(YY为年的后两位 00-99,MM :01-12,DD :01-31,HH :00-23,MM :00-59)receive_date string YYMMDDHHMM(YY为年的后两位 00-99,MM :0
8、1-12,DD :01-31,HH :00-23,MM :00-59)error_code string 未发送成功错误编码,参见真实网关错误码msg_group string 消息批次号,由云 MAS 平台生成, 用于验证短信提交报告和状态报告的一致性2.3 MO 数据结构类型( Type) :JSON 用途保存上行短信接口函数返回的短信内容。字段名数据类型说明typestring消息类型: 1 表示为提交报告, 2 表示为状态报告 ,3 表示为用户上行短信mobile string 手机号码,单个号码sms_content string 上行短消息内容send_time string 发送
9、时间(格式为yyyy-mm-dd hi24:mi:ss)serial string 客户上行目标服务代码。3功能介绍及使用3.1身份验证功能介绍企业必须通过身份验证才能进行短信发送, 身份验证用户名、 密码和集团客户名称完成。请求申明测试环境: http:/112.33.1.13:80/app/http/authorize 正式环境: http:/ 参数详解名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页,共 10 页 - - - - - - - - - . . 参数名称说明e
10、c_name 集团客户名称user_name 用户名user_passwd 密码返回值返回值描述mas_user_id 用户登录 id access_token API 输入参数签名密钥access_token_expire_seconds API 输入参数签名超时时间,超过此阈值后 API 输入参数签名密钥作废,需要重新申请,调用HTTP API 时应该在超时时间到达以前申请新的签名密钥status 验证状态,错误码请参考:3.1.1 3.1.1 错误码描述SC:4060登录验证请求超速Error: Invalid authorization 未通过授权Success 登录成功3.2发送普通
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 2022年中国移动通信有限公司政企客户分公司云MAS平台SDK接口. 2022 年中 移动 通信 有限公司 政企 客户 分公司 MAS 平台 SDK 接口
限制150内