跳到主要内容

预览策略赠予

GET/research/gifts/{gift_code}/preview在线调试
GET https://api.shengkezhi.com/open/v1/research/gifts/GIFT-8K3M2P/preview
等效 curl
curl "https://api.shengkezhi.com/open/v1/research/gifts/GIFT-8K3M2P/preview" \
  -H "Authorization: Bearer sk_xxx"

GET /research/gifts/{gift_code}/preview — 预览策略赠予。

需在请求头携带 Authorization: Bearer sk_xxx

请求参数

参数位置类型必填默认值说明
gift_codepathstring-32 位十六进制赠予码

响应 data

字段类型必填说明
already_claimedboolean本人是否已领取过;已领取时再次领取会原样回放,不重复拷贝。
claimableboolean整体是否可领:全部策略可用、名额未尽、且不是自己发的码。
expires_atstring过期时间,RFC3339。
from_user_idstring赠予方 user_id。
itemsGiftPreviewItem[]逐条策略的可领取状态。
remaining_claimsinteger剩余可领人数。

调用示例

curl -X GET "https://api.shengkezhi.com/open/v1/research/gifts/GIFT-8K3M2P/preview" \
-H "Authorization: Bearer sk_xxx"
{
"code": 0,
"data": {
"already_claimed": true,
"claimable": true,
"expires_at": "示例值",
"from_user_id": "experiment_20260701_001",
"items": [
{
"available": true,
"description": "示例值",
"reason": "示例值",
"strategy_code": "STRAT_MOMENTUM_001"
}
],
"remaining_claims": 1
},
"msg": "ok"
}