中国移动通信有限公司政企客户分公司云MAS平台SDK接口1.0.1(HTTP版)范例.docx

案卷号日期 云MAS平台SDK1.0.0（HTTP版） 用 户 手 册 作 者： 中国移动通信有限公司政企客户分公司 完成日期： 2015-12-7 签 收 人： 签收日期： 修改情况记录： 版本号修改内容修改日期修改人1.0.0草稿2015-12-7汪植成1.0.1签名错误或普通短信不允许使用模板短信的签名编码2016-04-20汪植成云MAS平台HTTP开发说明 简介 云MAS平台SDK HTTP版接口说明文档 背景 系统名称：云MAS平台 项目开发者： 中国移动通信集团政企客户分公司 定义 MT Message Terminal——下行短信，即向手机终端发送短信 MO Message Original——上行短信，即手机用户向特服号码发送短信 环境 服务器??有直连访问互联网的能力。并且提供HTTP Server接收比较报告，状态报告，上行短信。 云MAS平台与HTTP客户端数据交互流程 SDK收到的返回值说明： “1.返回提交状态”，说明云MAS是否收到HTTP提交的数据；数据还未提交行业网关； “4.返回审核结果”，说明云MAS已经对提交内容进行了审核；数据还未提交行业网关； “7.返回短信回复”，短信已经提交网关； “10.返回短信回执”，短信已被网关下发； *因平台有流控设置，需要进行多条短信连续提交时，为保证提交速度和效率，请按照“1.返回提交状态”返回值判断是否提交下一条； 数据结构说明 MT提交报告数据结构 类型（TYPE）：JSON 用途 用于内部，跟踪短信状态，不能用于判断短信是否正确送达，短信是否送达以移动公司提供的账单为准。 字段名数据类型说明typestring消息类型：1表示为提交报告，2表示为状态报告 ，3表示为用户上行短信,见附录4.1(8)report_statusstring状态报告的值，见附录4.1mobilesstring手机号码,多个手机号码英文半角逗号分隔submit_datestring发送时间（格式为yyyy-mm-dd hi24:mi:ss）receive_datestring接收时间（格式为yyyy-mm-dd hi24:mi:ss）error_codestring未发送成功错误编码，见附录4.1msg_groupstring消息批次号，由云MAS平台生成，用于验证短信提交报告和状态报告的一致性MT状态报告数据结构 类型（TYPE）：JSON 用途 保存状态报告接口函数返回的短信内容，不能用于判断短信是否正确送达，短信是否送达以移动公司提供的账单为准。 字段名数据类型说明 typestring消息类型：1表示为提交报告，2表示为状态报告 ，3表示为用户上行短信report_statusstring状态报告的值，参见真实网关状态报告值mobilestring手机号码，每次返回单个号码submit_datestringYYMMDDHHMM（YY为年的后两位00-99，MM：01-12，DD：01-31，HH：00-23，MM：00-59）receive_datestringYYMMDDHHMM（YY为年的后两位00-99，MM：01-12，DD：01-31，HH：00-23，MM：00-59）error_codestring未发送成功错误编码，参见真实网关错误码msg_groupstring消息批次号，由云MAS平台生成，用于验证短信提交报告和状态报告的一致性 MO数据结构 类型（Type）：JSON 用途 保存上行短信接口函数返回的短信内容。 字段名数据类型说明typestring消息类型：1表示为提交报告，2表示为状态报告 ，3表示为用户上行短信mobilestring手机号码，单个号码sms_contentstring上行短消息内容send_timestring发送时间（格式为yyyy-mm-dd hi24:mi:ss）serialstring客户上行目标服务代码。功能介绍及使用 身份验证 功能介绍 企业必须通过身份验证才能进行短信发送,身份验证用户名、密码和集团客户名称完成。 请求申明 测试环境：3:80/app/htt