系统支持的语言列表
接口信息
- 接口地址:
{your-site-url}/api/skill/base/get-languages - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址,如https://your-domain.com/admin - 请求方式:
GET - Content-Type:
application/json - 说明: 获取系统支持的全部语言列表。每个语言包含多语言名称、国际化编码、默认货币、国家代码和浏览器语言代码,用于店铺多语言创建、翻译等场景。
认证
请求头中需要携带 skill-access-token:
| Header | 值 |
|---|---|
skill-access-token |
{your-skill-access-token} (请替换为你自己的 token) |
请求参数
无请求参数。
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/base/get-languages' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'
返回结果
code 为 200 表示调用成功;code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"languages": {
"cn": {
"chinese_name": "简体中文",
"origin_name": "简体中文",
"english_name": "Simplified Chinese",
"full_code": "zh-CN",
"currency_code": "CNY",
"country_code": "CN",
"browser_code": "zh-CN",
"code": "cn"
},
"en": {
"chinese_name": "英语",
"origin_name": "English",
"english_name": "English",
"full_code": "en-US",
"currency_code": "USD",
"country_code": "US",
"browser_code": "en",
"code": "en"
}
}
},
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
Number | 状态码,200 表示成功 |
message |
String | 执行结果的文字描述 |
data |
Object | 返回数据 |
data.languages |
Object | 语言列表,键名为语言简码(如 cn、en),值为具体语言信息 |
languages 子项
| 字段 | 类型 | 说明 |
|---|---|---|
code |
String | 语言简码,如 cn、en、fr |
chinese_name |
String | 中文名称 |
origin_name |
String | 语言原生名称,如 English、Français、日本語 |
english_name |
String | 英文名称 |
full_code |
String | 完整语言区域码,格式 语言-国家,如 zh-CN、en-US |
currency_code |
String | 该语言区域的默认货币代码,如 USD、CNY、EUR |
country_code |
String | 该语言区域的默认国家代码(ISO 3166-1),如 US、CN、DE |
browser_code |
String | 浏览器语言标识代码,用于前端国际化 |
注意事项
- 该接口返回系统全部支持的语言,共 26 种,获取后缓存在本地即可,无需频繁调用。
code(语言简码)是语言唯一标识,用于创建店铺时指定语言。currency_code和country_code仅提供默认值,创建店铺时可单独覆盖。browser_code用于前端浏览器语言识别和自动跳转。