短信认证回执消息

当您使用短信认证服务API接口进行发送短信验证码后,可以通过配置轻量消息队列(原MNS)消费模式或HTTP批量推送模式接收短信验证码状态报告回执消息。

回执消息简介

接收回执消息的模式有轻量消息队列(原MNS)消费模式和HTTP批量推送模式两种,您可根据实际情况选择合适的模式接收回执消息。

轻量消息队列(原MNS)消费模式

轻量消息队列(原MNS)消费模式表示通过队列(Queue)模型来接收指定地域的短信验证码回执消息。云通信的所有业务消息都支持轻量消息服务向外发送。在号码认证控制台启用消息服务订阅指定的消息类型(MessageType)时,系统会自动生成该类型的独立消息队列及名称(QueueName)。您可使用此消息队列名称(QueueName)和消息类型(MessageType),通过调用SDK从后台来获取队列中的短信状态报告。

HTTP批量推送模式

HTTP批量推送模式表示通过HTTP POST方式发送消息到指定的Web URL。在号码认证控制台设置HTTP回调URL(callback_url)后,当业务消息产生时,系统会使用HTTP请求以POST方式将业务消息(即短信状态报告)发送到指定的回调URL上,可直接接收此消息。

回执消息类型

名称

描述

轻量消息队列(原MNS)消费模式

HTTP批量推送模式

DypnsSmsVerifyReport(短信验证发送状态报告接收)

开启DypnsSmsVerifyReport回执后,通过SendSmsVerifyCode接口发送短信验证码后可接收短信验证码发送状态报告消息。

DypnsSmsVerifyReport

DypnsSmsVerifyReport

配置回执消息

说明
  • 由于系统存在缓存,开启回执消息后不会立即全量推送,建议等待15分钟确认是否已生效。

  • 如果出现网络异常、响应超时等情况,可能会导致回执消息推送重复、回执消息获取失败等问题。如果回执消息获取失败,您可检查网络是否正常,稍后进行重试。

  • 回执消息不保证幂等性,如果开发者后续处理逻辑需要考虑幂等性,需要根据业务场景做合适的幂等处理。

配置步骤

  1. 登录号码认证控制台

  2. 在左侧导航栏短信认证服务 > 短信认证参数配置 > 状态报告接收页签,开启指定模式。

    轻量消息队列(原MNS)消费模式

    1. 开启轻量消息队列(原 MNS消息队列)消费模式右侧的功能开关。

      image

    2. 设置地域,选择地域。

      此地域须和调用接口时所选的地域一致。

    3. 单击确定,设置完成。

    HTTP批量推送模式

    说明

    HTTP批量推送模式的响应超时时间为700毫秒。

    1. 开启HTTP批量推送模式右侧的功能开关。

      image

    2. 填写回执消息的接收地址。

      说明

      在填写回执消息接收地址之前,您可以单击测试填入接收地址来测试您的接收地址是否能接收到回执消息。您的服务端接收地址需严格按照响应信息中的JSON格式进行返回。

      示例:http://push.example.com/contextpath/receive.do。

    3. 单击确定。设置完成。

相关文档

轻量消息队列(原MNS)消费Demo