帮助中心

18001-短信消息推送

2016-10-31

接口编号 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"
}



3461