8. 偶像端 API 8.28 发放福利【未授权拦截通过，待登录态联调】

Table of Contents

8.28 发放福利【未授权拦截通过，待登录态联调】

PATCH /tieup/api/v1/artist/benefit-redemptions/{redemption_id}/fulfill

鉴权：需要 Authorization: Bearer <access_token>。

路径参数：

参数 类型 必填 说明
redemption_id integer 是 兑换记录 ID

请求体：

{
  "fulfillment_remark": "顺丰 SF123456789，亲笔签名照已寄出"
}

请求参数：

参数 类型 必填 说明
fulfillment_remark string 是 发放备注，实物可写快递公司和单号，虚拟可写发放说明；最大 1000 字

响应字段：

字段 类型 说明
redemption_id integer 福利兑换记录 ID
redemption_status integer 福利兑换状态：1=待发放，2=已发放，3=已取消，4=已退款
fulfillment_remark string/null 发放备注
fulfilled_at string/null 发放时间

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "redemption_id": 60001,
    "redemption_status": 2,
    "fulfillment_remark": "顺丰 SF123456789，亲笔签名照已寄出",
    "fulfilled_at": "2026-06-23 15:00:00"
  }
}

说明：成功后更新 tieup_benefit_redemption.status = 2、fulfilled_at 和 fulfillment_remark。仅 status = 1 的待发放记录可发放，重复发放已完成记录按幂等返回。程序只记录备注和状态，具体实物或虚拟奖励由偶像自行兑现。