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"
}

规则优先级与有效期

服务端按以下顺序选择一条有效规则:

  1. 工作空间规则。
  2. API Key 对应账号的规则。
  3. 默认原价。