版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

...

consumes ["application/json"]

produces ["*/*"]

入参说明

参数名称参数说明请求类型参数类型描述
signature接口签名headerstring可用于第三方鉴权,加密方式参考签名鉴权
nonce
6位随机字符串bodystring
timestamp时间戳bodystring当前时间戳(毫秒)
userInfo用户身份bodymap

   "userInfo":{
        "identityType":"openid", //身份类型
        "identityValue":"obeXk1E7Vlt4YH5" //身份值

}

pushTitle通知标题bodystring
content通知的消息内容bodystring
pic图片地址bodystring可为空
toUrl点通知后的跳转地址bodystring可为空,url携带参数pageType=app时表示跳转App原生页面;pageType=h5时表示跳转App内嵌H5页面
msgId消息Idbodylong
当响应是异步是,会传递,同步则不会传
当响应是异步时会传递,同步则不会传
extras额外参数bodymap可自定义 key/value 信息,以供业务使用

请求示例

无格式
{
    "nonce":"XZTEKT",
    "timestamp":"1638011171354",
    "userInfo":{
        "identityType":"openid",
        "identityValue":"obeXk1E7Vlt4YH5Sy1ILz_WR8lbN"
    },
    "pushTitle":"我是标题",
    "content":"我是内容",
    "toUrl":null,
    "msgId":914230644929216512,
    "pic":null
}


4、返回触达结果

 1) 同步返回

参数名称参数类型是否必须描述
codestringtrue请求码,200-请求成功,其他为请求失败
resultinttrue触达结果,1为触达成功,0为触达失败
timestamplongfalse时间戳格式,触达用户的时间
msgstringtrue触达失败原因,客户回调兔展接口返回,当触达用户失败时(即code不等于200时)需要填写


2) 异步返回   调用工作台接口

接口地址 /api/integrate/callback/getMessage

...

接口描述 企业级接口,hearer必须携带X-Token

入参说明

参数名称参数说明请求类型参数类型是否必须
X-Token自建应用访问tokenheadertruetrue
msgId
消息Idbodylongtrue
result触达结果bodyinttrue
timestamp时间戳,触达用户的时间bodylong

 false

msg触达失败原因bodystringfalse