预览投研资产赠予

POST/research/gifts/preview在线调试

Authorization Bearer Token

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

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

等效 curl

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

POST /research/gifts/preview — 预览投研资产赠予。

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

请求体

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

响应 data

字段	类型	必填	说明
already_claimed	boolean	是	—
asset_type	GiftAssetType	是	—
claim_reason	string | null	否	—
claim_status	GiftClaimStatus	是	—
claimable	boolean	是	—
expires_at	string | null	否	—
from_user_id	string	是	—
items	GiftPreviewItem[]	是	—
remaining_claims	integer	是	—
resumable	boolean	是	—

GiftAssetType 取值

取值	说明
problem	-
factor_route	-
strategy	-

GiftClaimStatus 取值

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

GiftPreviewItem 字段

字段	类型	必填	说明
already_exists	boolean	是	策略已存在于领取方，领取时跳过并返回 inserted=false。
available	boolean	是	来源是否可用；已存在的策略仍可处理，但领取时跳过。
description	string	是	—
name	string	是	—
origin_code	string	是	—
reason	string | null	否	—

调用示例

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

{
  "code": 0,
  "data": {
    "already_claimed": false,
    "asset_type": "strategy",
    "claim_reason": null,
    "claim_status": "new",
    "claimable": true,
    "expires_at": "2026-09-16T10:00:00Z",
    "from_user_id": "01EXAMPLE000000000000000000",
    "items": [
      {
        "available": true,
        "description": "中频动量策略",
        "name": "动量策略",
        "origin_code": "STS_MOMENTUM_001",
        "reason": null
      }
    ],
    "remaining_claims": 9,
    "resumable": false
  },
  "msg": "ok"
}```