GET
/v1/earn/products/{id}
理财产品详情
Scope
earn:read
商户自身
⚠⚠ 本期这个端点调用即 500。 响应里的 min_amount / max_amount
在我方内部是大整数类型,序列化时会抛错 —— 于是不管产品存不存在,
你拿到的都是 500 api_error。别把它排进你的接入路径,
起购与上限请从后台配置或与我方对接时确认。这一条已报回我方,
修好之后本页会更新。
修好之后它返回的字段如下(kind = flexible 的产品 term_days 为
0;rollover_mode 的枚举是 none / principal /
principal_interest,不是 both)。
⚠ 定期的 apr_bps 是「现在下单会拿到的那个」,不是任何一张已有
订单的利率 —— 定期利率在下单那一刻快照进订单行,改挂牌价不影响存量。
活期相反:改利率是往历史表插一行,昨天的利息按昨天那一段算。
路径参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id |
string | 必填 | 产品 id。带不带 ern_ 前缀都认。 |
响应
200修好之后的形状。
min_amount / max_amount 为 0 表示不限。{
"id": "ern_7d2b48ae-19c3-4f60-8c55-0ab3e9f21744",
"asset": "USDT",
"kind": "fixed",
"term_days": 90,
"apr_bps": 620,
"min_amount": "100000000",
"max_amount": "0",
"ledger_scale": 6,
"renewable": true,
"rollover_mode": "principal",
"status": "active"
}403
insufficient_scope404
not_found —— 产品不存在,或没有对你开放。两种同一响应。500
api_error —— 本期恒定如此(见上方说明),不是你的请求有问题。
调用样例
curl -X GET 'https://api.zise.com/v1/earn/products/{id}' \
-H 'authorization: Bearer $TOKEN' \
-H 'x-zise-merchant: $MERCHANT_ID'
const res = await fetch(
"https://api.zise.com/v1/earn/products/{id}",
{
method: "GET",
headers: {
"authorization": "Bearer $TOKEN",
"x-zise-merchant": "MERCHANT_ID"
},
},
);
// 金额一律按字符串读,不要 JSON.parse 成 number
const data = await res.json();
import requests
res = requests.get(
"https://api.zise.com/v1/earn/products/{id}",
headers={
"authorization": "Bearer $TOKEN",
"x-zise-merchant": "$MERCHANT_ID"
},
)
# 金额用 Decimal(str(...)),不要 float
data = res.json()