时区、币种与官方标准
timezone 和 currency 使用国际标准标识。接口会检查代码是否存在于发布时固定的官方名单,而不仅检查字符串格式。
timezone:IANA 时区
Section titled “timezone:IANA 时区”填写 IANA Time Zone Database 中的时区标识,大小写必须准确。
| 示例 | 说明 |
|---|---|
America/Los_Angeles |
美国洛杉矶地区时区 |
Asia/Shanghai |
中国上海地区时区 |
Europe/London |
英国伦敦地区时区 |
Etc/UTC |
UTC |
地区时区包含当地历史和夏令时规则,不能用一个固定 GMT 偏移代替。比如 America/Los_Angeles 不能全年当作固定的 UTC−8 使用。
不再接受 GMT -8:00、+08:00 或自行编写的时区名称。不会自动猜测固定偏移对应哪个地区。IANA 官方别名会规范化,例如 US/Pacific 保存为 America/Los_Angeles。
IANA 官方资料
Section titled “IANA 官方资料”- IANA 时区数据库官网:数据库介绍与最新发布。
- IANA 发布目录:官方历史版本。
- 本接口使用的 tzdata 2026f:固定校验数据来源。
currency:ISO 4217
Section titled “currency:ISO 4217”填写 ISO 4217 三字母大写代码,不使用币种中文名称、货币符号或数字代码。
| 正确示例 | 含义 | 不接受的写法 |
|---|---|---|
USD |
美元 | usd、$、840 |
CNY |
人民币 | RMB、人民币 |
EUR |
欧元 | eur、€ |
接口以 ISO 4217 官方维护机构 SIX 的 List One: Current Currency & Funds 为校验名单。ZZZ 等不存在的代码会被拒绝;标准名单有效与后续业务支持范围是两回事。
ISO 4217 官方资料
Section titled “ISO 4217 官方资料”- ISO 4217 币种代码官网:标准说明、字母代码与数字代码。
- SIX 官方维护页面:现行代码、历史代码及变更公告。
- SIX List One 官方 XML:当前货币与资金代码完整名单。
本接口校验版本
Section titled “本接口校验版本”| 数据 | 当前固定版本 |
|---|---|
| IANA 时区数据库 | 2026f |
| SIX ISO 4217 List One | 发布日期 2026-09-17 |
标准数据随接口版本更新,不会在每次请求时在线下载。官方名单今后有变更时,请以本文公布的接口版本为准。
非法时区或币种返回 HTTP 400,错误码为 INVALID_EXTERNAL_ORDER。请修正后提交;不要靠更换请求 ID 重试同一份错误数据。