1. 开发指南
OpenAPI
  • 开发指南
    • 开发前必读
    • 申请API Key 与 API Secret
    • 错误码指引
    • 接口签名
    • 接口响应安全校验
    • 多语言
    • 时区相关
    • 更新日志
    • Webhook Beta
    • 业务幂等相关
  • API 使用指南
    • 公共服务
      • 基础配置信息
    • 用户
      • 用户注册
      • 用户列表
      • 用户详情
      • 获取KYC Token
      • 获取KYC H5链接
    • 卡业务
      • 卡渠道列表
      • 实体卡邮寄地址列表
      • 创建实体卡邮寄地址
      • 修改实体卡邮寄地址
      • 删除实体卡邮寄地址
      • 申请卡
      • 激活实体卡
      • 卡列表
      • 卡详情
      • 卡CVV信息
      • 卡交易列表
      • 卡交易详情
      • 重置免密支付金额
      • 重置实体卡 PIN
      • 冻结卡
      • 解冻卡
    • 钱包
      • 钱包列表
      • 链列表
      • 创建钱包链地址
      • 钱包详情
      • 链上收款人列表
      • 链上收款人详情
      • 创建链上收款人
      • 更新链上收款人
      • 删除链上收款人
      • 创建钱包提现交易
      • 取消钱包提现交易
      • 钱包站内划转
      • 钱包划转到卡
      • 钱包交易列表
      • 钱包交易详情
    • 服务调试
      • GET请求调试
      • POST请求调试
  • 数据模型
    • response.Response
  1. 开发指南

多语言

API 支持的语言与区域(国际化)说明#

本文档说明了 API 支持的语言与区域设置。API 使用 Accept-Language 头来决定返回内容的首选语言。

语言代码格式#

所有语言代码遵循 BCP 47 标准格式:language-COUNTRY
language:ISO 639-1 两字母语言代码(小写)
COUNTRY:ISO 3166-1 alpha-2 国家/地区代码(大写)

用法#

在请求中包含 Accept-Language 头,例如:

支持的语言#

阿拉伯语#

语言代码描述
ar-SA阿拉伯语(沙特阿拉伯)

孟加拉语#

语言代码描述
bn-BD孟加拉语(孟加拉国)
bn-IN孟加拉语(印度)

中文#

语言代码描述
zh-CN中文(简体,中国)
zh-HK中文(繁体,香港)
zh-TW中文(繁体,台湾)

捷克语#

语言代码描述
cs-CZ捷克语(捷克共和国)

丹麦语#

语言代码描述
da-DK丹麦语(丹麦)

荷兰语#

语言代码描述
nl-BE荷兰语(比利时)
nl-NL荷兰语(荷兰)

英语#

语言代码描述
en-AU英语(澳大利亚)
en-CA英语(加拿大)
en-GB英语(英国)
en-IE英语(爱尔兰)
en-IN英语(印度)
en-NZ英语(新西兰)
en-US英语(美国)
en-ZA英语(南非)

芬兰语#

语言代码描述
fi-FI芬兰语(芬兰)

法语#

语言代码描述
fr-BE法语(比利时)
fr-CA法语(加拿大)
fr-CH法语(瑞士)
fr-FR法语(法国)

德语#

语言代码描述
de-AT德语(奥地利)
de-CH德语(瑞士)
de-DE德语(德国)

希腊语#

语言代码描述
el-GR希腊语(希腊)

希伯来语#

语言代码描述
he-IL希伯来语(以色列)

印地语#

语言代码描述
hi-IN印地语(印度)

匈牙利语#

语言代码描述
hu-HU匈牙利语(匈牙利)

印度尼西亚语#

语言代码描述
id-ID印度尼��亚语(印度尼西亚)

意大利语#

语言代码描述
it-CH意大利语(瑞士)
it-IT意大利语(意大利)

日语#

语言代码描述
ja-JP日语(日本)

韩语#

语言代码描述
ko-KR韩语(韩国)

马来语#

语言代码描述
ms-MY马来语(马来西亚)
ms-SG马来语(新加坡)

挪威语#

语言代码描述
no-NO挪威语(挪威)

波兰语#

语言代码描述
pl-PL波兰语(波兰)

葡萄牙语#

语言代码描述
pt-BR葡萄牙语(巴西)
pt-PT葡萄牙语(葡萄牙)

罗马尼亚语#

语言代码描述
ro-RO罗马尼亚语(罗马尼亚)

俄语#

语言代码描述
ru-RU俄语(俄罗斯)

斯洛伐克语#

语言代码描述
sk-SK斯洛伐克语(斯洛伐克)

西班牙语#

语言代码描述
es-AR西班牙语(阿根廷)
es-CL西班牙语(智利)
es-CO西班牙语(哥伦比亚)
es-ES西班牙语(西班牙)
es-MX西班牙语(墨西哥)
es-US西班牙语(美国)

瑞典语#

语言代码描述
sv-SE瑞典语(瑞典)

泰米尔语#

语言代码描述
ta-IN泰米尔语(印度)
ta-LK泰米尔语(斯里兰卡)

泰语#

语言代码描述
th-TH泰语(泰国)

土耳其语#

语言代码描述
tr-TR土耳其语(土耳其)

越南语#

语言代码描述
vi-VN越南语(越南)

实现示例#

HTTP 请求示例#

多语言偏好(Multiple Language Preferences)#

你可以使用质量值(q)指定多个语言偏好:
表示的优先顺序:
1.
首选中文(简体,中国)
2.
备用:美式英语(权重 0.9)
3.
备用:任意英语(权重 0.8)

编程语言示例#

JavaScript / Node.js#

Python#

Java#

cURL#

响应本地化(Response Localization)#

本地化错误信息(Localized Error Messages)#

错误信息会以请求中的语言返回,例如:
英文(en-US):
{
  "code": 20001,
  "message": "User not found"
}
中文(zh-CN):
{
  "code":  20001,
  "message": "用户未注册"
}
西班牙语(es-ES):
{
  "code":  20001,
  "message": "Usuario no encontrado"
}

回退策略(Fallback Strategy)#

如果请求的语言不被支持,API 将按以下顺序回退:
1.
完全匹配:尝试寻找精确的 language-country 匹配
2.
语言回退:回退到基础语言(例如 en-US)
3.
默认语言:回退到英语(en-US)

示例回退流程#

请求: Accept-Language: en-CAAAA
回退顺序:
1.
en-CAAAA(不存在的语言)
2.
en-US(美国英语)— 语言回退

最佳实践(Best Practices)#

针对 API 使用方(API Consumers)#

1.
始终设置 Accept-Language:在请求中包含首选语言
2.
尽量使用具体地域代码:区分 en-US 与 en-GB 等
3.
处理回退:准备好接受回退语言的响应
4.
跨区域测试:使用不同语言测试你的应用兼容性

针对 API 实现方(API Implementation)#

1.
校验语言代码:只处理支持的语言代码
2.
记录语言偏好:用于分析与统计
3.
缓存本地化内容:提高性能
4.
及时更新翻译:保持译文准确和最新

语言代码参考表#

快速参考,所有支持的语言代码如下:
ar-SA, bn-BD, bn-IN, cs-CZ, da-DK, de-AT, de-CH, de-DE, el-GR, 
en-AU, en-CA, en-GB, en-IE, en-IN, en-NZ, en-US, en-ZA, es-AR, 
es-CL, es-CO, es-ES, es-MX, es-US, fi-FI, fr-BE, fr-CA, fr-CH, 
fr-FR, he-IL, hi-IN, hu-HU, id-ID, it-CH, it-IT, ja-JP, ko-KR, 
ms-MY, ms-SG, nl-BE, nl-NL, no-NO, pl-PL, pt-BR, pt-PT, ro-RO, 
ru-RU, sk-SK, sv-SE, ta-IN, ta-LK, th-TH, tr-TR, vi-VN, zh-CN, 
zh-HK, zh-TW
修改于 2026-01-23 03:34:42
上一页
接口响应安全校验
下一页
时区相关
Built with