ai_member_xiaobian/.agents/skills/lark-base/references/lark-base-advperm-disable.md
2026-05-15 10:57:05 +08:00

2.1 KiB
Raw Permalink Blame History

base +advperm-disable

前置条件: 先阅读 ../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

停用指定 Base 的高级权限。停用后自定义角色等高级权限功能将不可用。

推荐命令

# 停用高级权限
lark-cli base +advperm-disable \
  --base-token VwGhbYCXQaYGMzsWlEZcBbfMnod

参数

参数 必填 说明
--base-token <token> Base Token27 位字母数字字符串

API 入参详情

HTTP 方法和路径:

PUT /open-apis/base/v3/bases/:base_token/advperm/enable?enable=false

Path 参数:

参数 必填 说明
base_token Base 的唯一标识27 位字母数字字符串

Query 参数:

参数 必填 类型 说明
enable bool 固定为 false,表示停用高级权限

API 出参详情

Response

字段 类型 说明
code int32 错误码0 表示成功
message string 错误信息
data string 成功时为空

返回值

命令成功后输出 JSON

{
  "ok": true,
  "data": {
    "success": true
  }
}

工作流

Caution

这是高风险写入操作 — 停用高级权限会影响所有已配置的自定义角色,执行前必须向用户确认。

  1. 向用户确认 --base-token,并提醒停用会影响已有角色配置
  2. 执行命令
  3. 确认返回 code: 0 表示停用成功

坑点

  • ⚠️ 操作用户必须为 Base 管理员:非管理员调用会返回权限错误
  • ⚠️ 停用影响已有角色:停用高级权限后,已创建的自定义角色将失效
  • ⚠️ API 路径版本:本接口使用 base/v3,路径必须从原始文档提取,不要用 WebSearch 补全
  • ⚠️ data 字段是 JSON 字符串:响应中 data 是 string 类型(非 object需要双重解析

参考