帮助中心
进入EZR

18001-短信消息推送

2020-12-23

接口编号 18001

接口说明

驿氪系统的短信发送请求，将全部转发给客户的自定义接口处理。

注：

1.驿氪系统的短信发送请求，将全部转发给客户的自定义接口处理。

2.该调用由驿氪发起，第三方提供支持HTTP POST请求的接口地址给驿氪；

3.目前只提供单条的请求转发，驿氪内部有队列实现机制，不会造成对客户接口的洪峰；

4.客户接口需要返回运营商发送的网关ID(GatewayId), 方便对账处理；

5.关于签名安全，详见：接口接入指南，客户接口需要做签名验证处理以保证是合法的请求；

6.若条件允许，客户接口服务器可做域名访问来源的安全限制；

第三方成功处理需要返回{"Status": true,"StatusCode": 200,…}，见返回结果示例；

请求说明

  • HTTP请求方式：POST

  • 返回数据格式：JSON

  • 请求路径：callback（调用方提供支持POST方式的接口地址）

请求参数


字段类型为空长度描述
MsgIdstring

消息编号,方便核对使用
Channelint

发送通道：0=验证码通道、1=营销通道
MobileNostring

手机号
Zonestring

手机区号，例如：86
Contentstring

消息内容，不带签名

请求参数示例代码（json对象）

{
    "MsgId": "57df9bd94dd6936c7c798887",
    "Channel": 0,
    "Content": "亲爱的用户您好。本次注册的验证码为981232，有效时间5分钟。",
    "MobileNo": "18988888888",
    "Zone": "86",
}


系统级返回结果示例（json）

指第三方接口需要返回的结果格式（非200的状态码代表发送失败）

{
    "Status": true,
    "StatusCode": 200,
    "Msg": "成功", 
    "GatewayId": "201607191619580811"
}



5475