使用场景:

这是一个C端触发的接口。兔展平台发券后通知企业用户与券绑定关系。 兔展系统调用第三方的接口

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

请求方式 POST

consumes ["application/json"]

produces ["application/json"]

应用权限 优惠券->发券通知订阅

#请求参数


###公共参数

参数名称参数说明请求类型是否必须数据类型schema
orgId企业IDbodytrueString
appInstanceId应用实例IDbodytrueString
noticeData通知数据bodytruearray发券通知
nonce签名随机数stringtrueString签名随机数
timestamp签名时间戳longtrueLong签名时间戳
signature签名stringtrueString签名
instanceAppId自建应用appidstringtrueString
thirdCompanyId开放平台登陆componyIdstring非开放平台用户为空String

###发券通知

参数名称参数说明请求类型是否必须数据类型schema
thirdCouponTplId第三方卡券模板IDbodytrueString
couponCode券CODEbodytrueString
thirdId客户IDbodyfalsestring
openids多应用身份标识bodyfalsearray多应用身份标识
phone手机bodyfalsestring

###多应用身份标识

参数名称参数说明请求类型是否必须数据类型schema
unionid微信unionidbodyfalseString
openid应用身份标识bodytrueString
fromTo应用类型(contentminiapp:小程序, workwechat:企业微信外部联系人, gzh:公众号, workwechatgroup:客户群)bodytruestring
appid应用idbodyfalsestring
jcappid兔展系统集成-自建应用ID(是一串数字,非自建应用的应用ID(一窜字母字符串))bodyfalsenumber(64)
identityType身份识别类型(phone: 手机号码, id: 第三方用户ID, openid: 公众号openid, unionid: 开放平台unionid)bodyfalsestring
identityId身份识别类型ID, identityType 字段对应的value值bodyfalsestring

###请求示例

{
  "appInstanceId": "778985290508406784",
  "orgId": "928a852d-e749-45be-bc31-f8e23f07b7f4",
  "noticeData": [
    {
      "phone": "18681452902",
      "thirdCouponTplId": "SINGLE_LINE_COMMON_MIN_1.0815c",
      "openids": [
        {
          "openid": "o2shHwg9VjkygpN6__rHOyQ5Y2lE",
          "appid": "wxa1a8ae7a3acd6d38",
          "fromTo": "gzh"
        }
      ],
      "openidDtos": [
                {
                    "openid": "o2shHwg9VjkygpN6__rHOyQ5Y2lE",
                    "appid": "wxa1a8ae7a3acd6d38",
                    "fromTo": "gzh"
                }
            ]
        }
     ],
      "couponCode": "77a794d7-26d2b29e7"
    }
  ],
  "nonce": "n14GvACT6Ed768TUlJHKwD2Ml2ej89n1",
  "timestamp": 1625793771858 ,
  "instanceAppId": "Ipu_t60KoV-gTTtCSkFMWtrkTIA",
  "thirdCompanyId": "0707",
  "signature": "1d11d6b2be2113fd42519be97421b1ad0ddcb1e5"
}

#响应参数


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

###响应状态

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

###响应示例

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

  • 无标签