跳到主要内容

投研资产赠予列表

GET/research/gifts在线调试
GET https://api.shengkezhi.com/open/v1/research/gifts
等效 curl
curl "https://api.shengkezhi.com/open/v1/research/gifts" \
  -H "Authorization: Bearer sk_xxx"

GET /research/gifts — 投研资产赠予列表。

返回本人发出的赠予历史(含已撤回/已过期),领取明细来自个人 business.duckdb;过期状态由 expires_at 读时推导。

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

响应 data​

字段类型必填说明
itemsGiftView[]是—

GiftView 字段​

字段类型必填说明
asset_codesstring[]是—
asset_namesstring[]是与 asset_codes 等长的展示名;缺失时与 code 相同。
asset_typeGiftAssetType是—
claim_recordsGiftClaimRecord[]是已成功领取该码的明细(发出方视角)。
claimedinteger是—
created_atstring是—
expires_atstring是—
gift_codestring是—
max_claimsinteger是—
statusGiftOutStatus是active / revoked / expired(expired 由 expires_at 读时推导)。
ttl_daysinteger是—
unavailable_asset_codesstring[]是—

GiftAssetType 取值​

取值说明
problem-
factor_route-
strategy-

GiftClaimRecord 字段​

字段类型必填说明
asset_typeGiftAssetType是—
claimed_atstring是—
from_user_idstring是—
gift_codestring是—
itemsGiftClaimItem[]是—
recipient_user_idstring是—

GiftOutStatus 取值​

取值说明
active-
revoked-
expired-

GiftClaimItem 字段​

字段类型必填说明
insertedboolean是—
namestring否领取方落地后的展示名;旧账本缺省时为空,由列表接口回填。
origin_codestring是—
origin_namestring否赠予方资产展示名;旧账本缺省时为空,由列表接口回填。
renamedboolean是—
target_codestring是—

HTTP 状态​

状态码说明
200赠予码列表

调用示例​

curl -X GET "https://api.shengkezhi.com/open/v1/research/gifts" \
-H "Authorization: Bearer sk_xxx"
{
"code": 0,
"msg": "ok",
"data": {
"items": []
}
}