中国移动通信有限公司政企客户分公司云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——上行短信，即手机用户向特服号码发送短信环境服务器具有直连访问互联网的能力。并且提供HTTPServer接收比较报告，状态报告，上行短信。云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/http/authorize正式环境：/app/http/authorize参数详解参数名称说明ec_name集团客户名称user_name用户名user_passwd密码返回值返回值描述mas_user_id用户登录idaccess_tokenAPI输入参数签名密钥access_token_expire_secondsAPI输入参数签名超时时间，超过此阈值后API输入参数签名密钥作废，需要重新申请，调用HTTPAPI时应该在超时时间到达以前申请新的签名密钥status验证状态，错误码请参考：.1错误码描述SC:4060登录验证请求超速Error: Invalid authorization未通过授权Success登录成功发送普通短信HTT