插件:多语言-获取菜单子项翻译

获取指定菜单项的原始名称和多语言翻译数据。编辑前建议先通过 插件:多语言-翻译语言列表 确认翻译语言,修改后通过 插件:多语言-保存菜单子项翻译 保存。

接口信息

  • 接口地址: {your-site-url}/api/skill/addons-language/get-menu-item-translate
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/apimanager666
  • 请求方式: GET
  • 说明: 获取菜单项的原始名称(menu_item_data)以及各语言的翻译数据(menu_item_tranlate)。用于多语言编辑页面——展示基础语言名称,同时加载各语言的已有翻译。

认证

请求头中需要携带 skill-access-token

Header
skill-access-token {your-skill-access-token} (请替换为你自己的 token)

请求参数 (Query)

字段 类型 必填 说明
menu_item_id int 菜单项 ID。从 菜单树-详细 返回的 menu_tree_items 中获取

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/addons-language/get-menu-item-translate?menu_item_id=2185' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

code200 表示调用成功;code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "menu_item_data": {
            "name": "home"
        },
        "menu_item_tranlate": [
            {
                "id": 833,
                "shop_id": 15,
                "menu_item_id": 2185,
                "lang_code": "cn",
                "name": "首页",
                "created_at": "2026-06-07 18:17:11",
                "updated_at": "2026-06-07 18:17:11"
            },
            {
                "id": 834,
                "shop_id": 15,
                "menu_item_id": 2185,
                "lang_code": "ja",
                "name": "ホーム",
                "created_at": "2026-06-07 18:17:11",
                "updated_at": "2026-06-07 18:17:11"
            }
        ]
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码,200 表示成功
message String 执行结果的文字描述
data Object 菜单项翻译数据

data 字段

字段 类型 说明
menu_item_data Object 菜单项的默认/基础语言数据
menu_item_tranlate Array[Object] 菜单项各语言的翻译数据
字段 类型 说明
name string 菜单项原始名称(基础语言)
字段 类型 说明
id int 翻译记录 ID。保存时需传回
shop_id int 店铺 ID
menu_item_id int 菜单项 ID
lang_code string 语言简码。与 插件:多语言-翻译语言列表code 对应
name string 翻译后的菜单项名称
created_at string 创建时间
updated_at string 最后更新时间

注意事项

  1. 菜单项的 menu_item_id菜单树-详细 返回的 menu_tree_items 中每个菜单项的 id 字段获取
  2. menu_item_tranlate 中可能不含某些语言的翻译(语言刚添加或未编辑),UI 应对缺失语言提供空输入框
  3. 保存时需将翻译记录的 id 一并传回
  4. 编辑完整流程:翻译语言列表 → 本接口获取翻译数据 → 回填 UI → 保存翻译
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-06-07 18:32:04

results matching ""

    No results matching ""