新建 / 更新自定义菜单

开发中

POST

https://api.flashcat.cloud/custom-menu/upsert

最后修改时间：2026-05-08 09:36:24

需要 701 自定义菜单管理权限。
新建时 menu_id 传 0 或省略；更新时必传当前菜单的 menu_id。
后端单事务完成：菜单写入 + 权限点动态生成 + 角色位图差集 + permission_key 现算回吐。

请求参数

Authorization

API Key

在 header 添加参数

Flashcat-Context

示例：

Flashcat-Context: ********************

Body 参数application/json必填

示例

返回响应

🟢200

application/json

成功

Bodyapplication/json

🟠400

🟠403

🟠404

请求示例

Shell

JavaScript

Java

Swift

cURL

新建更新

curl --location 'https://api.flashcat.cloud/custom-menu/upsert' \
--header 'Flashcat-Context: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "parent_key": "__root__",
    "slot_after_key": "/incident",
    "rank": "h",
    "label": {
        "zh_CN": "BI 看板",
        "en_US": "BI Dashboard"
    },
    "icon": "chart",
    "mode": "iframe",
    "url": "https://bi.example.com/embed",
    "role_ids": [
        102,
        103
    ]
}'

响应示例

200 - 示例 1

{
    "menu_id": 0,
    "permission_key": "customMenu:visit:8123412309128"
}

修改于 2026-05-08 09:36:24

获取单个自定义菜单详情

删除自定义菜单