开发者工具 › 指南
Node 与 Python 两个 SDK:签名、重试、幂等键都已经封好。
SDK
它们替你做了什么
- 签名 —— 包括最容易写错的「PATH 进签名串」
- 重试 —— 504 用同一把幂等键重试,业务失败不重试
- 金额 —— 一律按字符串处理,不会经过 JS number / Python float
它们不替你做的
- 不缓存令牌到磁盘 —— 令牌该活在内存里
- 不自动分页 —— 游标分页要你自己决定什么时候停
- 不吞错误 —— 业务失败原样抛出,让你按
code分支
金额:两种语言各有一个坑
// Node —— 别 parseFloat
const amount = data.amount; // "100.000000" ✓
const bad = parseFloat(data.amount); // 精度已经没了 ✗
# Python —— 用 Decimal(str(...)),别 float()
from decimal import Decimal
amount = Decimal(data["amount"]) # ✓
bad = float(data["amount"]) # ✗