文档首页 > > API参考> 接收上行短信API

接收上行短信API

分享
更新时间: 2019/09/23 GMT+08:00

接口功能

该接口用于客户接收短信平台主动发送的上行短信通知,接收该短信的地址需要提供给管理员。

注:国际/港澳台短信暂不支持上行短信功能。

使用说明

前提条件

已在创建短信应用时填写上行短信接收地址。

若客户需要对上行短信进行AK/SK鉴权,则客户需提前向管理员说明并提供AK/SK给管理员,若客户对短信平台发送的上行短信免鉴权则无需提供。

客户服务器若有IP白名单配置,请联系运营经理获取短信平台IP地址并加入白名单。

接口类型

表1 接口类型说明

请求方法

POST

访问URI

客户接收上行短信的地址。

通信协议

HTTPS

请求参数

表2 请求Headers参数

参数名称

是否必选

参数类型

默认值

说明

Content-Type

String

固定填application/x-www-form-urlencoded。

表3 请求Body参数说明

参数名称

是否必选

参数类型

默认值

说明

smsMsgId

String(1-50)

上行短信的唯一标识。

from

String(1-21)

上行短信发送方的号码。

to

String[](1-21)

上行短信接收方的号码。

body

String(1-160)

上行短信发送的内容。

响应参数

客户可以返回任意响应消息给短信平台,短信平台不会对响应消息处理。

接口示例

  • 请求示例
    POST /smsRecive HTTP/1.1
    Host: 205.145.111.168:9330
    Content-Type: application/x-www-form-urlencoded
    Connection: close
    Pooltype: approxy
    Ompsid: 56514cc1880e40638f16c7c674265658
    TerminalIP: 205.141.112.17
    TrcModule: AP
    UserTrace: application
    TraceHandle: DMZ_818405
    
    from=%2B8615502795172&to=201804131431201234&body=********&smsMsgId=9692b5be-c427-4525-8e73-cf4a6ac5b3f7
  • 响应示例
    HTTP/1.1 200 OK
    Date: Fri, 13 Apr 2018 06:31:48 GMT
    Content-Type: application/JSON; charset=UTF-8
    Content-Length: 43
    
    {"returnCode":0,"returnCodeDesc":"Success"}

相关推荐

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区