GET
/v1/members/{id}/limits
该会员的额度占用(只读,不下发上限)
Scope
members:read
代会员调用 · 必带 x-on-behalf-of
给它是为了让你能解释「为什么这一笔被拒」—— 失败码本身刻意只给
limit_exceeded,不带阈值。
⚠ 不下发上限。 上限是平台配置且随风控档位变化;下发一个数会被
你拿去在自己那边先判一次,于是两个事实源,而漂移的表现是
「你判过了,我方仍然拒」。
⚠ 会员由路径参数定位,x-on-behalf-of 在这个端点上不生效。
路径参数两种标识都认。
window 自带作用域与日期(形如 exch:day:USDT-USD:2026-08-12、
itr:send:day:2026-08-12),原样给、原样显示 —— 切开反而丢信息,
而窗口键的构成规则不是公开契约、随业务线新增而扩充。
used 是定点整数串,位数看该资产的 ledger_scale
(从 GET /v1/assets 取)。没有任何占用的会员返回空数组。
路径参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id |
string | 必填 | external_member_id 或 mem_<uuid>。这个端点不看
x-on-behalf-of,会员完全由这个路径参数决定。 |
响应
200OK
{
"data": [
{
"window": "exch:day:USDT-USD:2026-08-12",
"asset": "USDT",
"used": "500000000",
"op_count": 3,
"updated_at": "2026-08-12T09:31:02.441Z"
}
],
"next_cursor": null,
"has_more": false
}404
member_not_found(含「属于别的商户」)
调用样例
curl -X GET 'https://api.zise.com/v1/members/{id}/limits' \
-H 'authorization: Bearer $TOKEN' \
-H 'x-zise-merchant: $MERCHANT_ID' \
-H 'x-on-behalf-of: $MEMBER_ID'
const res = await fetch(
"https://api.zise.com/v1/members/{id}/limits",
{
method: "GET",
headers: {
"authorization": "Bearer $TOKEN",
"x-zise-merchant": "MERCHANT_ID",
"x-on-behalf-of": "MEMBER_ID"
},
},
);
// 金额一律按字符串读,不要 JSON.parse 成 number
const data = await res.json();
import requests
res = requests.get(
"https://api.zise.com/v1/members/{id}/limits",
headers={
"authorization": "Bearer $TOKEN",
"x-zise-merchant": "$MERCHANT_ID",
"x-on-behalf-of": "$MEMBER_ID"
},
)
# 金额用 Decimal(str(...)),不要 float
data = res.json()