插件:多语言-获取菜单子项翻译
获取指定菜单项的原始名称和多语言翻译数据。编辑前建议先通过 插件:多语言-翻译语言列表 确认翻译语言,修改后通过 插件:多语言-保存菜单子项翻译 保存。
接口信息
- 接口地址:
{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}'
返回结果
code 为 200 表示调用成功;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 |
最后更新时间 |
注意事项
- 菜单项的
menu_item_id 从 菜单树-详细 返回的 menu_tree_items 中每个菜单项的 id 字段获取
menu_item_tranlate 中可能不含某些语言的翻译(语言刚添加或未编辑),UI 应对缺失语言提供空输入框
- 保存时需将翻译记录的
id 一并传回
- 编辑完整流程:翻译语言列表 → 本接口获取翻译数据 → 回填 UI → 保存翻译