使用场景:

这是一个B端触发的接口。兔展平台触发优惠券同步后通知企业开始同步优惠券



接口地址 由第三方企业开发者或中间件开放接口并在自建应用中配置通知地址

请求方式 POST

consumes ["application/json"]

produces ["application/json"]

应用权限 优惠券->优惠卷同步通知

#请求参数


###公共参数

参数名称参数说明请求类型是否必须数据类型schema
orgId企业IDbodytrueString
appInstanceId应用实例IDbodytrueString
noticeData通知数据bodytruearray优惠券同步通知
nonce签名随机数stringtrueString签名随机数
timestamp签名时间戳longtrueLong签名时间戳
signature签名stringtrueString签名

###优惠券同步通知,请求参数noticeData的数据格式

参数名称参数说明请求类型是否必须数据类型schema
batchId批次ID,同步任务标识bodytruestring
thirdCouponTplId第三方卡券模板IDbodyfalseString
couponTypes卡券类型, 数组bodyfalsestring

###请求示例

{
  "orgId": "928a852d-e749-45be-bc31-f8e23f07b7f4",
  "appInstanceId": "778985290508406784",
  "noticeData": [
    {
      "batchId": "780862735507394560",
      "couponTypes":["type1"]
    }
  ],
  "nonce": "n14GvACT6Ed768TUlJHKwD2Ml2ej89n1",
  "timestamp": 1625793771858 ,
  "signature": "1d11d6b2be2113fd42519be97421b1ad0ddcb1e5"
}

#响应参数


参数名称参数说明请求类型是否必须数据类型schema
code状态码bodytruestring
msg描述bodytruestring

###响应状态

状态码说明schema
200OK
201Created
401Unauthorized
403Forbidden
404Not Found
500FAIL

###响应示例

{
  "code": "200",
  "errorCode": "SUCCESS",
  "msg": "通讯成功"
}

  • 无标签