奖励中心- 发放奖励 - WhaleAPI（Public）

用于外部接口发放现金、实物、卡券奖励

Request

Authorization

Header Params

x-member-id

integer

required

用户ID

Example:

5120003232

Body Params application/json

request_id

string <uuid>

required

发奖请求唯一标识（UUID）

>= 36 characters<= 36 characters

Example:

f8b1d802-c4bd-439b-bcde-c81c496af119

type

enum<string>

required

奖励类型：cash(现金)、merch(实物)、coupon(卡券)

Allowed values:

cashmerchcoupon

campaign_code

string

required

归属活动 Code

>= 1 characters<= 100 characters

Example:

JC1772174345

cash_value

object

optional

现金奖励价值（仅现金奖励必填）

currency

enum<string>

required

现金币种（仅现金奖励必填）

Allowed values:

HKDUSD

amount

integer

required

现金数值（仅现金奖励必填，单位：分）

>= 1

Example:

7500

code

string

optional

奖品 Code（实物、卡券奖励必填）

>= 1 characters<= 100 characters

Example:

M6957U350

remark

string

optional

发奖备注

<= 200 characters

Example:

测试发奖

Example

{
  "request_id": "f8b1d802-c4bd-439b-bcde-c81c496af119",
  "type": "cash",
  "campaign_code": "JC1772174345",
  "cash_value": {
    "currency": "HKD",
    "amount": 7500
  },
  "code": "M6957U350",
  "remark": "测试发奖"
}

Responses

🟢200Success

application/json

Body

code

string

required

Example:

200

message

string

required

data

object

optional

ref_no

string

required

发放流水号

Example:

ceeeb96e52b2aa538c97037259c59834

status

integer

required

奖励状态

Example:

Example

{
  "code": "200",
  "message": "string",
  "data": {
    "ref_no": "ceeeb96e52b2aa538c97037259c59834",
    "status": 12
  }
}