全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
流量服务

流量回执消息

更新时间:2017-10-27 16:14:09

简介

当您使用流量的API接口充值完流量后,可以通过使用MNS的Queue模型来接收充值的回执消息,假如服务出现异常情况时(如网络问题),导致消息回执未成功获取,还可以通过充值状态查询API接口进行一定的补偿(目前支持30天内发送记录的查询)。

消息的订阅

云通信的所有业务消息都用过MNS消息服务向外发送。用户每订阅一个类别的消息(比如流量充值回执报告消息FlowReport),系统都会为用户分配一个独立的消息队列。用户可以通过阿里云账号拿到一个临时的token用于获取队列中的消息。用户可以下载demo,编写简单的消息处理类即可完成消息处理的任务。在页面上订阅消息,订阅完消息后,能拿到消息队列名称(queueName)。比如:Alicom-Queue-xxxxxx-FlowReport 。队列名字每个用户都不同。

消息类型

流量提供一种消息类型,流量充值回执消息FlowReport

流量充值回执消息FlowReport消息体格式
名称 类型 描述 示例 是否必须
phone String 充值的手机号 13000000000 必须
out_id String 外部扩展ID,在充值接口调用时指定 123 必须
result String 充值结果 3-充值成功,4-充值失败 必须
err_code String 错误码 UNKNOW 可选
err_msg String 错误信息描述 未知错误 可选

技术对接步骤

下载消息SDK

下载对应流量的消息DEMO工程,工程所需要的所有依赖php包都放在DEMO工程的目录下,将对于的php包引入到您的工程当中既可按照DEMO样例编写接收消息的程序。

SDK&DEMO[下载地址]

编写样例程序

  1. // 代码节选,详见aliyun-dycdp-php-sdk/msg_demo/MsgDemo.php
  2. ...
  3. echo "消息接口查阅流量服务状态报告返回结果:\n";
  4. MsgDemo::receiveMsg(
  5. // 消息类型, FlowReport: 流量服务状态报告
  6. "FlowReport",
  7. // 在云通信页面开通相应业务消息后,就能在页面上获得对应的queueName
  8. "Alicom-Queue-xxxxxxxx-FlowReport",
  9. /**
  10. * 回调
  11. * @param stdClass $message 消息数据
  12. * @return bool 返回true,则工具类自动删除已拉取的消息。返回false,消息不删除可以下次获取
  13. */
  14. function ($message) {
  15. print_r($message);
  16. return false;
  17. }
  18. );
本文导读目录