Growth Studio OpenAPI接入文档 · Discounts and Wallet Transactions
查询当前 API Key 对应账号与绑定工作空间适用的折扣。平台与 OpenAPI 共用同一套折扣规则,不区分渠道或功能。
接口返回查询时的有效规则。实际扣款由服务端在计费时独立计算,以钱包流水为准。
GET /openapi/v1/wallet/discount
Authorization: Bearer <API_KEY>
无需请求参数。账号与工作空间由 API Key 确定,不支持通过请求参数或 Header 覆盖为其他账号、工作空间或折扣。
curl --request GET \
"${BASE_URL}/openapi/v1/wallet/discount" \
--header "Authorization: Bearer ${API_KEY}"
HTTP 状态码:200 OK。
{
"discount": "70",
"source": "workspace",
"expires_at": "2026-12-31T15:59:59Z",
"request_id": "wallet-discount-001"
}
| 字段 | 类型 | 说明 |
|---|---|---|
discount |
string | 应付比例的百分比整数字符串,范围 "1"~"100"。"70" 表示支付原价的 70%,即七折;"100" 表示原价 |
source |
string | 当前规则来源:workspace 为工作空间规则,account 为 API Key 对应账号的规则,default 为默认原价 |
expires_at |
string / null | 当前选定规则的截止时刻,采用 RFC3339 格式,服务端返回 UTC 时间。不限时或使用默认原价时为 null |
request_id |
string | 请求追踪 ID,与响应头 X-Request-Id 一致 |
响应包含 Cache-Control: no-store,客户端不应缓存该查询结果。示例中的截止时间对应北京时间 2026-12-31 23:59:59。
没有适用规则时,响应如下:
{
"discount": "100",
"source": "default",
"expires_at": null,
"request_id": "wallet-discount-001"
}
服务端按以下顺序选择一条有效规则: