接收上行短信API
功能介绍
该接口用于用户接收短信平台主动发送的上行短信通知，接收该通知的上行短信接收地址在创建短信应用时配置。
前提条件
- 已在创建短信应用时填写上行短信接收地址。
- 用户服务器若有IP白名单配置，请联系运营经理获取短信平台IP地址并加入白名单。
调试
您可以参考接收上行短信代码样例，进行快速上手调试。
接口类型
请求方法 |
POST |
|---|---|
访问URI |
用户接收上行短信的地址。 |
通信协议 |
HTTPS/HTTP |
回调接口使用HTTPS协议时，服务端需支持TLS1.2，加密套件需支持TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256，TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384，TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256，TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384中的一种或多种。
请求参数
参数名称 |
是否必选 |
参数类型 |
默认值 |
说明 |
|---|---|---|---|---|
Content-Type |
是 |
String |
无 |
固定填application/x-www-form-urlencoded。 |
参数名称 |
是否必选 |
参数类型 |
默认值 |
说明 |
|---|---|---|---|---|
smsMsgId |
是 |
String(1-50) |
无 |
上行短信的唯一标识。 |
from |
是 |
String(1-21) |
无 |
上行短信发送方的号码。 |
to |
是 |
String(1-21) |
无 |
上行短信接收方的号码。 |
body |
是 |
String(1-160) |
无 |
上行短信发送的内容。 |
createTime |
否 |
String(1-20) |
无 |
上行短信创建时间，即短信平台接收到用户发送的上行短信的时间（采用标准UTC格式，例如：2018-02-12T15:30:20Z。不同编程语言中的时间格式转换方式不同，部分语言可参考表 不同编程语言的时间格式）。 在控制台创建应用时，配置需要“接收上行短信回复时间”后（缓存原因，配置后需等待5分钟左右生效），平台才会在Body中附带此字段，该字段只对http协议的短信生效。 |
响应参数
用户可以返回任意响应消息给短信平台，短信平台不会对响应消息处理。
请求示例
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=%2B86155****5172&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"}
