状态推送接口 开发文档


短信接口类型

短信接口有五种:
1、短信接口一,自定义短信发送内容,适合:会员群发通知、会员营销群发等,有 人工审核点击查看详情
2、短信接口二,通过传入短信模版CID发送短信,适合:验证码、订单短信、物流类、监控类等触发类短信,可以 自动审核下发点击查看详情
3、个性化短信群发接口,通过传入短信模版CID发送短信,适合:订单短信、物流类、监控类等触发类短信,可以 自动审核下发点击查看详情
4、获取手机用户的短信上行
5、获取短信接收状态

以上五种接口,通过配置和设置不同参数区分使用。

这五种短信接口支持中国移动中国联通中国电信的全国范围手机号码。


状态推送接口详情

接口主要功能

√ 获取短信接收状态。

 

接口地址
由微米用户提供的合法HTTP地址

 

HTTP请求方式

GET

 

接口参数
名称 类型 是否必须 示例值 描述
mob String 1391******* 单一手机号码
mid String d4d61ffd-****-****-****-07ecd0796b98 消息ID,与调用下发接口时返回的“msgId”匹配
report String DELIVRD 具体接收状态,参考下一章节《状态含义》
time String 2012-10-11 18:30:00 状态接收时间,格式:yyyy-MM-dd HH:mm:ss

 

结果代码
代码 结果描述 解决方案
0 成功接收推送的状态 必须保证返回0,否则视为失败,将重复提交
其他 接收失败 请确认服务器端的接口可以正常访问

 

状态含义
状态代码 状态描述 失败原因
DELIVRD 成功接收短信
MK:0001 接收短信失败 空号
MK:0005 接收短信失败 停机
MK:0012 接收短信失败 空号
MK:0008 接收短信失败 超频
MK:100D 接收短信失败 黑名单用户
UNDELIV 接收短信失败 终端网络异常或黑名单用户造成的失败
其他 接收失败 具体失败原因,请联系在线客服

 

注意事项

√ 状态推送接口由微米用户按照参数规范编写,保证能正常被微米调用,接收短信状态。
√ 如果因为接口无法访问,造成数据上传失败,微米会尝试10次,第一次的间隔时间是10秒;第二次20秒;第三次40秒;以此类推。如果尝试10次仍无法成功,微米将暂时关闭上行接口推送。如果仍需要推送状态,请恢复接口后与微米客服在线联系。
√ 状态推送接口在微米后台“账户设置”中配置。

 


请参考

√ 开发文档

√ 彩信接口

√ 账户余额查询接口

√ PHP示例

√ Java示例

√ Python示例

√ Node.js示例

√ C#示例

 

下载文档 | Java示例源代码 | PHP示例源代码 | 我的微米 | 常见问题 | 微米使用流程 | 联系客服