领取投研资产赠予

POST/research/gifts/claim在线调试

Authorization Bearer Token

请求体 JSON{"gift_code":"GIFT-8K3M2P"}

POST https://api.shengkezhi.com/open/v1/research/gifts/claim

等效 curl

curl "https://api.shengkezhi.com/open/v1/research/gifts/claim" \
  -H "Authorization: Bearer sk_xxx" \
  -H "Content-Type: application/json" \
  --data '{"gift_code":"GIFT-8K3M2P"}'

POST /research/gifts/claim — 领取投研资产赠予。

需在请求头携带 Authorization: Bearer sk_xxx。

请求体

字段	类型	必填	说明
gift_code	string	是	—

响应 data

字段	类型	必填	说明
asset_type	GiftAssetType	是	—
claim_status	GiftClaimStatus	是	—
from_user_id	string	是	—
items	GiftClaimItem[]	是	—

GiftAssetType 取值

取值	说明
problem	-
factor_route	-
strategy	-

GiftClaimStatus 取值

取值	说明
new	尚未领取。
pending	已排队，等待领取。
processing	正在复制资产。
failed	领取失败，可用同一赠予码重试。
done	领取完成。

GiftClaimItem 字段

字段	类型	必填	说明
inserted	boolean	是	—
name	string	否	领取方落地后的展示名；旧账本缺省时为空，由列表接口回填。
origin_code	string	是	—
origin_name	string	否	赠予方资产展示名；旧账本缺省时为空，由列表接口回填。
renamed	boolean	是	—
target_code	string	是	—

调用示例

curl -X POST "https://api.shengkezhi.com/open/v1/research/gifts/claim" \
  -H "Authorization: Bearer sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{"gift_code":"GIFT-8K3M2P"}'

{
  "code": 0,
  "data": {
    "asset_type": "problem",
    "claim_status": "done",
    "from_user_id": "experiment_20260701_001",
    "items": [
      {
        "inserted": true,
        "origin_code": "STRAT_MOMENTUM_001",
        "renamed": true,
        "target_code": "STRAT_MOMENTUM_001"
      }
    ]
  },
  "msg": "ok"
}```