Admin 接口概览

运营后台走 Admin 会话(登录双 token + RBAC),不是 API Key。完整路径以 docs/openapi/openapi.yaml 为准。

鉴权

能力路径
登录POST /api/v1/auth/login
刷新POST /api/v1/auth/refresh-token
当前账号GET /api/v1/auth/me
登出POST /api/v1/auth/logout
动态菜单GET /api/v1/admin/get-async-routes

按钮级权限用后端权限码;前端 v-perms / hasPerms 认单 * 通配。

分组(导航级)

分组典型前缀说明
系统/api/v1/admin/accountsrolesmenusdeptsdicts账号与 RBAC
项目 / Key/api/v1/admin/projectsapi-keys下游项目与网关凭证
内容/api/v1/admin/videoscomicsnovelspostsdramas五类型 CRUD、导入、上下架
外部资源/api/v1/admin/external-resources*同步台账,不是 catalog
会员/api/v1/admin/users*C 端用户治理
支付 / 渠道Admin 支付与渠道模块套餐、订单、渠道配置
埋点/api/v1/admin/analytics*看板与漏斗
监控 / 任务/api/v1/admin/monitor*scheduled-jobs在线、日志、cron
配置中心/api/v1/admin/config*存储与动态配置
工作台/api/v1/admin/workbench*运营首页漏斗

内容导入与短剧规则见 内容管线。页面能力见 后台管理系统

和 BaaS 的区别

  • Admin 成功响应:业务字段平铺 + request_id
  • App 成功响应:统一信封 {code, message, data, request_id}
  • 不要用 Admin token 调 /api/v1/app/*,也不要用 API Key 冒充运营登录。