系统支持的语言列表

接口信息

  • 接口地址: {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'

返回结果

code200 表示调用成功;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 语言列表,键名为语言简码(如 cnen),值为具体语言信息

languages 子项

字段 类型 说明
code String 语言简码,如 cnenfr
chinese_name String 中文名称
origin_name String 语言原生名称,如 English、Français、日本語
english_name String 英文名称
full_code String 完整语言区域码,格式 语言-国家,如 zh-CNen-US
currency_code String 该语言区域的默认货币代码,如 USDCNYEUR
country_code String 该语言区域的默认国家代码(ISO 3166-1),如 USCNDE
browser_code String 浏览器语言标识代码,用于前端国际化

注意事项

  1. 该接口返回系统全部支持的语言,共 26 种,获取后缓存在本地即可,无需频繁调用。
  2. code(语言简码)是语言唯一标识,用于创建店铺时指定语言。
  3. currency_codecountry_code 仅提供默认值,创建店铺时可单独覆盖。
  4. browser_code 用于前端浏览器语言识别和自动跳转。

results matching ""

    No results matching ""