查询营销活动查询奖励

1 接口说明

P云为接口提供方,用于查询奖励详情。

2 请求地址

GET https://api.4pyun.com/gate/1.0/bonus/bonus

测试环境:https://dev-api.4pyun.com/gate/1.0/bonus/bonus

3 请求方式

HTTP GET,URL 传参。

4 请求参数

字段 类型 必须 说明
app_id string Y 应用ID,由P云分配
id int64 Y 奖励ID

5 响应参数

字段 类型 必须 说明
id int64 Y 奖励ID
cover string N 奖励封面
value int32 Y 奖励面额,单位分
quantity int32 Y 奖励数量
identity string Y 用户ID,登录授权获取
status int32 Y 奖励状态:0未发放, 1 发放中,2已领取
api_bonus_id string N 微信等第三方券编码
grant_time timestamp N 发放时间
apply_status int32 Y 核销状态:0未核销,1 已核销
apply_time timestamp N 核销时间
effect_time timestamp N 生效时间
expire_time timestamp N 失效时间
issuer string N 发放人
apply_desc string N 奖励描述
remark string N 备注
children array[object] N 子奖励记录

children

字段 类型 必须 说明
id int64 N 奖励ID
value int32 N 奖励面额,单位分
status int32 N 奖励状态:0未发放, 1 发放中,2已领取
api_bonus_id string N 微信等第三方券编码
grant_time timestamp N 发放时间
apply_status int32 N 核销状态
apply_time timestamp N 核销时间
effect_time timestamp N 生效时间
expire_time timestamp N 失效时间

6 错误码

附录 - 错误码

© 2026 Shenzhen ChinaRoad Technology Co., Ltd. © All Rights Reserved            UPDATED 2026/09/11 20:04:16

results matching ""

    No results matching ""