第三方商品(使用商家级别appkey和appSecret)
前期准备
说明:
- 获取签名supplierKey即为签名中的appKey supplierSecret即为签名中的appSecret。
- 设置请求地址。
1. 获取第三方商品列表
接口说明
该接口由开发者提供给通兑吧
商家在通兑吧商城后台添加第三方商品,会请求开发者服务器获取商品列表
时序图
API文档
- 请求类型:GET
- 签名规则请查询签名算法
- 请求参数
变量名 | 是否必填 | 长度 | 类型 | 说明 |
---|---|---|---|---|
page | 是 | 11 | int | 当前请求页面 默认0 0表示第一页 |
pageSize | 是 | 11 | int | 每页条数 默认100 |
type | 是 | 10 | string | 商品类型 prize商品 coupon优惠券 |
- 返回信息
参数 | 是否必须 | 类型 | 说明 |
---|---|---|---|
code | 是 | int | 返回状态码(参考状态码定义部分) |
msg | 是 | string | 返回错误信息, code=0,则为"success" |
data | 是 | objects | 响应数据 |
totalCount | 是 | int | 商品总条数 |
rows | 是 | array | 商品列表 |
id | 是 | string | 商品id |
name | 是 | string | 商品名称 |
number | 是 | int | 商品数量 |
discountType | 否 | int | 优惠券类型 1立减券 2满减券 3折扣券 请求参数type等于coupon传此参数 |
discountAmount | 否 | int | 优惠券金额 单位分(如果折扣券 此值=折扣*10 例如 8折 discountAmount = 80) 请求参数type等于coupon传此参数 |
discountCondition | 否 | int | 优惠券条件 满减券传此值 单位分 |
startAt | 否 | int | 优惠券使用开始时间戳 |
endAt | 否 | int | 优惠券使用结束时间戳 |
-返回示例
#商品示例
{
"code":0,
"msg": "success",
"data": {
"totalCount": 200,
"rows": [{
"id": "商品id",
"name": "商品名称",
"number": "商品数量"
},{
"id": "商品id",
"name": "商品名称",
"number": "商品数量"
}
...
]
}
}
#优惠券示例
{
"code":0,
"msg": "success",
"data": {
"totalCount": 200,
"rows": [{
"id": "商品id",
"name": "商品名称-满减券",
"number": 100
"discountType": 2,
"discountAmount": 100,
"discountCondition": 10000,
"startAt": 1609481016,
"endAt" 1612073016:
},{
"id": "商品id",
"name": "商品名称-立减券",
"number": 200,
"discountType": 1,
"discountAmount": 100,
"discountCondition": 0,
"startAt": 1609481016,
"endAt" 1612073016:
}
...
]
}
}
2. 发放第三方商品通知开发者
时序图
接口说明
该接口由开发者提供给通兑吧
c端用户通过活动获取第三方商品时,请求该接口通知开发者服务器。第三方提供的商品必须保证可以发放给用户, 如果多次发放全部发放失败,则需要人工处理退款或者补偿。
无论接受到的结果如何,只要开发者收到该请求,请返回,无响应或失败, 通兑吧会在之后隔2,5,13,35,97,275,793,2315,6817,20195秒通知一次, 共补发通知10次。
注:出于网络异常的可能性,通兑吧可能会对开发者进行重复通知,开发者务必确保一笔订单不进行重复处理,否则将产生严重bug
API文档
- 请求类型:GET
- 签名规则请查询签名算法
- 请求参数
变量名 | 是否必填 | 长度 | 类型 | 说明 |
---|---|---|---|---|
unionId | 是 | 32 | string | 开发者用户唯一标识 |
orderId | 是 | 100 | string | 发奖唯一流水号(长度100) |
id | 是 | 11 | string | 商品id |
number | 是 | 11 | int | 商品数量 默认1 |
- 返回信息
参数 | 是否必须 | 类型 | 说明 |
---|---|---|---|
code | 是 | int | 返回状态码(参考状态码定义部分) |
msg | 是 | string | 返回错误信息, code=0,则为"success" |
data | 是 | objects | 响应数据 成功null |
-返回示例
{
"code":0,
"msg": "success",
"data": null
}