{ "openapi": "3.1.0", "info": { "title": "cfapi.aog.cc 管理平台 API", "version": "1.11.0", "description": "## 简介\n\ncfapi.aog.cc 统一 API 网关。本文件是唯一权威 API 合同，由 GET /api/openapi.json 原样返回；openapi_extra.json 已废弃。\n\n## 版本前缀\n\n所有接口同时挂载在两个前缀下，内容完全一致：\n\n- /api/... —— 兼容前缀，永久保留。\n- /api/v1/... —— 推荐新接入使用。将来出现不兼容变更时新增 /api/v2，保留 /api/v1。\n\n本文档路径以 /api 书写；把 /api 换成 /api/v1 即等价。\n\n## 鉴权与权限\n\n- 公开接口：无需令牌，本文件标记 security: []。\n- 业务接口：Authorization: Bearer ；部分接口也接受 ?token=，但客户端不应依赖查询参数传递长期凭据。\n- API Key 的 scopes 是前置闸门，不是完整授权；仍需经过账号层级/RBAC。\n- 插件读取/写操作分别需要权限码 plugin.view / plugin.manage；市场治理操作需要 plugin.govern。\n- 权限码和真实登录身份缺一不可。只拿到 external 层级不会自动获得插件权限码。\n\n## 插件开发资料\n\n- 开发者中心：/docs/devcenter/\n- AI 索引：/docs/devcenter/llms.txt\n- 完整上下文：/docs/devcenter/llms-full.txt\n- 清单 JSON Schema：/docs/devcenter/schemas/plugin-manifest.schema.json\n\n插件包清单是 plugin.json；私有安装 POST /api/plugins/upload?code=...（raw ZIP，需 plugin.manage）；市场投稿 POST /api/market/upload?plugin_code=...（multipart 字段 file，无需 plugin.manage）。市场批准不会自动安装、启用、部署或启动沙箱。\n\n## 统一响应体\n\n{ \"code\": 0, \"message\": \"ok\", \"data\": {} }\n\n| code | 含义 |\n|------|------|\n| 0 | 成功 |\n| 40000 | 参数错误 |\n| 40100 | 未认证 |\n| 40300 | 无权限 |\n| 40400 | 不存在 |\n| 40900 | 冲突 |\n| 50000 | 内部错误 |\n\n## 限流\n\n敏感端点按 IP/用户维度限流，命中返回 40300 或 429。额度可在后台实时调整；填 0 表示不限。\n\n## 合同覆盖边界\n\n本文件覆盖已核对并纳入合同的公开与插件路由；它不等于对源码中每一条内部运维路由的完整性承诺。部分内部/管理接口的请求体仍标记为 internal-admin-generic；插件对外稳定流程以本文件、开发者中心和 plugin.json Schema 为准。x-required-permission 与接口描述用于补充权限语义，不替代实际鉴权。", "contact": { "name": "cfapi.aog.cc", "url": "https://cfapi.aog.cc" } }, "servers": [ { "url": "https://cfapi.aog.cc", "description": "生产网关" } ], "components": { "securitySchemes": { "bearer": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" } }, "schemas": { "ApiError": { "type": "object", "properties": { "code": { "type": "integer", "example": 40100 }, "message": { "type": "string", "example": "登录已过期或无效，请重新登录" }, "data": { "type": "null" } } }, "LoginReq": { "type": "object", "required": [ "username", "password" ], "properties": { "username": { "type": "string", "example": "admin" }, "password": { "type": "string", "example": "admin888888" } } }, "LoginResult": { "type": "object", "properties": { "token": { "type": "string" }, "user": { "$ref": "#/components/schemas/AdminUser" }, "permissions": { "type": "array", "items": { "type": "string" } } } }, "AdminUser": { "type": "object", "properties": { "id": { "type": "integer" }, "username": { "type": "string" }, "nickname": { "type": "string" }, "email": { "type": [ "string", "null" ] }, "phone": { "type": [ "string", "null" ] }, "department_id": { "type": "integer" }, "status": { "type": "integer", "description": "1=启用 0=禁用" }, "is_super": { "type": "integer", "description": "1=超级管理员" } } }, "AppUser": { "type": "object", "properties": { "id": { "type": "integer" }, "username": { "type": "string" }, "nickname": { "type": "string" }, "email": { "type": [ "string", "null" ] }, "phone": { "type": [ "string", "null" ] }, "status": { "type": "integer" } } }, "Role": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "code": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "status": { "type": "integer" } } }, "Permission": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "code": { "type": "string" }, "category": { "type": "string" }, "description": { "type": [ "string", "null" ] } } }, "Department": { "type": "object", "properties": { "id": { "type": "integer" }, "parent_id": { "type": "integer" }, "name": { "type": "string" }, "sort": { "type": "integer" }, "status": { "type": "integer" } } }, "Plugin": { "type": "object", "description": "插件注册记录。manifest 为 plugin.json 原始内容（含菜单/权限/入口）。", "properties": { "id": { "type": "integer" }, "code": { "type": "string", "example": "demo" }, "name": { "type": "string" }, "version": { "type": "string" }, "ptype": { "type": "string", "enum": [ "local", "remote" ] }, "base_url": { "type": "string", "description": "插件后端地址；local 无后端可留空" }, "status": { "type": "integer", "description": "1=启用 0=停用" }, "manifest": { "type": "string", "description": "plugin.json 原文(JSON 字符串)" } } }, "PluginManifest": { "type": "object", "description": "插件清单 plugin.json。上传安装时 code 必须与 query code 一致；type 为登记标签，wasm/sandbox 执行需另建 active 沙箱配置。", "required": [ "code" ], "properties": { "code": { "type": "string", "pattern": "^[a-z0-9_]{1,64}$", "description": "仅小写字母、数字、下划线，1-64 位" }, "name": { "type": "string" }, "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" }, "type": { "type": "string", "enum": [ "local", "remote", "wasm", "sandbox", "disabled" ], "default": "local" }, "base_url": { "type": "string", "maxLength": 512, "description": "remote 必填；非超管提交禁止内网/回环地址" }, "description": { "type": "string" }, "entry": { "type": "string", "description": "相对入口；禁止绝对路径与 ..。local 静态入口固定 index.html，entry 不改变页面入口。" }, "permissions": { "type": "array", "items": { "type": "string", "pattern": "^(\\*|[A-Za-z0-9_.:-]+)$" }, "default": [], "description": "权限声明。可用平台权限码（如 plugin.view）或 resource:action。上传路径不强制冒号；/api/manifest/scan 更严格。声明不等于授权。" }, "dependencies": { "type": "array", "items": { "type": "object", "required": [ "plugin" ], "properties": { "plugin": { "type": "string", "pattern": "^[a-z0-9_]+$" }, "version": { "type": "string", "default": "*" }, "optional": { "type": "boolean", "default": false } } } }, "requirements": { "type": "object", "properties": { "memory_mb": { "type": "integer", "minimum": 0 }, "cpu_shares": { "type": "integer", "minimum": 0 }, "disk_mb": { "type": "integer", "minimum": 0 }, "features": { "type": "array", "items": { "type": "string" } } }, "default": { "memory_mb": 64, "cpu_shares": 100, "disk_mb": 10, "features": [] } }, "icon": { "type": "string" }, "menu": { "type": "object", "properties": { "title": { "type": "string" }, "path": { "type": "string" }, "permission": { "type": "string" } } } }, "additionalProperties": true }, "MarketEntry": { "type": "object", "description": "市场目录中的单个插件条目。type=remote 仅登记 base_url（零文件操作）；type=local 从 download_url 拉包落地（市场策展地址，非用户任意 URL）。", "properties": { "code": { "type": "string", "example": "demo_remote" }, "name": { "type": "string" }, "version": { "type": "string" }, "description": { "type": "string" }, "type": { "type": "string", "enum": [ "local", "remote" ] }, "base_url": { "type": "string", "description": "remote 类型插件后端域名" }, "download_url": { "type": "string", "description": "local 类型插件包地址（市场策展，可信）" }, "author": { "type": "string" }, "logo": { "type": "string" } } }, "MarketInstallReq": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "string", "description": "市场目录中的插件 code（小写字母/数字/下划线）" } } }, "PluginTokenReq": { "type": "object", "required": [ "scopes" ], "properties": { "scopes": { "type": "array", "items": { "type": "string" }, "minItems": 1 }, "ttl": { "type": "integer", "minimum": 60, "maximum": 2592000, "default": 3600, "description": "秒；缺省 3600" } } }, "PluginTokenVerifyReq": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string" } } }, "PluginUserRegisterReq": { "type": "object", "required": [ "username", "password" ], "properties": { "username": { "type": "string" }, "password": { "type": "string", "format": "password" }, "email": { "type": "string" }, "display_name": { "type": "string" } } }, "PluginUserLoginReq": { "type": "object", "required": [ "username", "password" ], "properties": { "username": { "type": "string" }, "password": { "type": "string", "format": "password" } } }, "PluginAiChatReq": { "type": "object", "required": [ "messages" ], "properties": { "provider": { "type": "string" }, "model": { "type": "string" }, "messages": { "type": "array", "items": { "type": "object" } }, "max_tokens": { "type": "integer", "minimum": 1 } } }, "PluginKvPutReq": { "type": "object", "required": [ "value" ], "properties": { "value": { "description": "任意 JSON 值" }, "ttl_secs": { "type": "integer", "minimum": 1, "description": "过期秒数；缺省或 0 表示永不过期" } } }, "PluginPaymentReq": { "type": "object", "required": [ "amount_micros" ], "properties": { "user_id": { "type": "integer" }, "amount_micros": { "type": "integer", "minimum": 1 }, "currency": { "type": "string", "default": "CNY" }, "description": { "type": "string" } } }, "PluginPushReq": { "type": "object", "required": [ "event", "data" ], "properties": { "room": { "type": "string" }, "event": { "type": "string" }, "data": { "description": "任意 JSON 值" } } }, "PluginRoomReq": { "type": "object", "required": [ "room" ], "properties": { "room": { "type": "string" }, "description": { "type": "string" } } }, "UiSlotReq": { "type": "object", "required": [ "slot_name" ], "properties": { "slot_name": { "type": "string" }, "plugin_code": { "type": "string", "description": "管理端创建时必填；插件自管理时由路径 code 覆盖" }, "title": { "type": "string" }, "config_json": { "description": "任意 JSON 配置" }, "sort_order": { "type": "integer", "default": 0 }, "enabled": { "type": "integer", "enum": [ 0, 1 ], "default": 1 } } }, "HookRegisterReq": { "type": "object", "required": [ "event_name", "callback_url" ], "properties": { "event_name": { "type": "string" }, "callback_url": { "type": "string" }, "secret": { "type": "string", "default": "" }, "is_active": { "type": "integer", "enum": [ 0, 1 ], "default": 1 }, "timeout_ms": { "type": "integer", "default": 10000 }, "retry_count": { "type": "integer", "default": 2 } } }, "RpcGrantReq": { "type": "object", "required": [ "caller_code", "target_code", "method" ], "properties": { "caller_code": { "type": "string" }, "target_code": { "type": "string" }, "method": { "type": "string", "description": "子路径；* 表示全部" } } }, "RpcCallReq": { "type": "object", "required": [ "target" ], "properties": { "target": { "type": "string" }, "method": { "type": "string", "description": "目标子路径/方法名，必须命中显式 RPC 授权" }, "payload": { "description": "任意 JSON，作为请求体转交目标" } } }, "SchedulerCreateReq": { "type": "object", "required": [ "schedule_type", "schedule_value", "callback_url" ], "properties": { "schedule_type": { "type": "string", "enum": [ "interval", "cron", "daily" ] }, "schedule_value": { "type": "string", "description": "interval: 秒数；cron: 表达式；daily: HH:MM" }, "callback_url": { "type": "string" } } }, "SchedulerUpdateReq": { "type": "object", "properties": { "schedule_type": { "type": "string", "enum": [ "interval", "cron", "daily" ] }, "schedule_value": { "type": "string" }, "callback_url": { "type": "string" }, "enabled": { "type": "integer", "enum": [ 0, 1 ] } } }, "JobEnqueueReq": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "job_type": { "type": "string", "default": "http" }, "job_name": { "type": "string" }, "dedupe_key": { "type": "string" }, "payload": { "description": "任意 JSON" }, "target_url": { "type": "string" }, "priority": { "type": "integer" }, "max_attempts": { "type": "integer" }, "run_at": { "type": "string", "description": "YYYY-MM-DD HH:MM:SS 或 ISO；now/空表示立即" } } }, "DataStorePutReq": { "type": "object", "required": [ "value" ], "properties": { "namespace": { "type": "string", "default": "default" }, "value": { "type": "string", "description": "字符串值（按源码为 String）" } } }, "MarketRatingReq": { "type": "object", "required": [ "plugin_code", "rating" ], "properties": { "plugin_code": { "type": "string" }, "rating": { "type": "integer", "minimum": 1, "maximum": 5 }, "comment": { "type": "string", "maxLength": 512 } } }, "MarketReviewReq": { "type": "object", "properties": { "notes": { "type": "string" } } }, "PluginConfigSchema": { "type": "object", "required": [ "fields" ], "properties": { "fields": { "type": "array", "items": { "type": "object", "required": [ "key", "type", "label" ], "properties": { "key": { "type": "string" }, "type": { "type": "string", "enum": [ "string", "number", "boolean", "password", "url", "select" ] }, "label": { "type": "string" }, "default": {}, "required": { "type": "boolean" }, "placeholder": { "type": "string" }, "options": { "type": "array", "items": { "type": "object", "required": [ "label", "value" ], "properties": { "label": { "type": "string" }, "value": { "type": "string" } } } }, "min": { "type": "number" }, "max": { "type": "number" }, "description": { "type": "string" } } } } } }, "UpdateProfileReq": { "type": "object", "properties": { "username": { "type": "string" }, "nickname": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" } } }, "CreateApiKeyReq": { "type": "object", "properties": { "label": { "type": "string" }, "scopes": { "type": "string", "description": "逗号/空格分隔的 scope，默认 *；仍不能高于账号权限" }, "expires_hours": { "type": "integer", "description": "0 或省略表示不过期" }, "tier": { "type": "string", "enum": [ "external", "internal", "internal_advanced" ], "description": "请求层级；服务端会收敛到不高于归属账号" } } }, "InterPluginCallReq": { "type": "object", "properties": { "method": { "type": "string", "default": "POST" }, "body": { "description": "转交给目标插件的 JSON" }, "headers": { "type": "object", "additionalProperties": { "type": "string" } } } }, "WebhookInboxReq": { "type": "object", "required": [ "source", "event_type", "payload" ], "properties": { "source": { "type": "string", "maxLength": 64 }, "event_type": { "type": "string", "maxLength": 64 }, "payload": { "description": "任意 JSON，最大 256 KiB" }, "secret": { "type": "string" } } }, "PublicPluginDocReq": { "type": "object", "required": [ "captcha_token", "captcha_answer" ], "description": "业务字段直接平铺在顶层，另加验证码字段；不是 { data: {...} } 包装。", "additionalProperties": true, "properties": { "captcha_token": { "type": "string" }, "captcha_answer": { "type": "string" } } }, "OpenAIChatReq": { "type": "object", "required": [ "model", "messages" ], "properties": { "model": { "type": "string" }, "messages": { "type": "array", "items": { "type": "object" } }, "temperature": { "type": "number" }, "max_tokens": { "type": "integer" }, "stream": { "type": "boolean" } }, "additionalProperties": true }, "AnthropicMessagesReq": { "type": "object", "required": [ "model", "messages", "max_tokens" ], "properties": { "model": { "type": "string" }, "messages": { "type": "array", "items": { "type": "object" } }, "max_tokens": { "type": "integer" }, "system": { "type": "string" }, "stream": { "type": "boolean" } }, "additionalProperties": true }, "PublicAiReportReq": { "type": "object", "description": "报告字段直接平铺在顶层，另加可选验证码。", "additionalProperties": true, "properties": { "captcha_token": { "type": "string" }, "captcha_answer": { "type": "string" } } }, "ErrorResponse": { "type": "object", "description": "所有失败响应的统一结构。HTTP 状态码表达传输层语义，code 表达业务语义，两者不可互相替代。", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "业务码：40000 参数错误 / 40100 未认证 / 40300 无权限 / 40400 不存在 / 40900 冲突 / 42900 限流 / 50000 内部错误 / 50300 暂不可用" }, "message": { "type": "string", "description": "可直接展示给用户的中文说明；不要依赖其字面内容做程序分支" }, "data": { "description": "失败时固定为 null", "type": [ "object", "null" ] } }, "example": { "code": 40300, "message": "缺少权限: plugin.manage", "data": null } } }, "responses": { "Unauthorized": { "description": "未认证（40100）", "content": { "application/json": { "example": { "code": 40100, "message": "登录已过期或无效，请重新登录", "data": null }, "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "Forbidden": { "description": "无权限（40300）", "content": { "application/json": { "example": { "code": 40300, "message": "缺少权限: dashboard.view", "data": null }, "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "BadRequest": { "description": "参数错误（40000）", "content": { "application/json": { "example": { "code": 40000, "message": "密码长度需为 6-64 个字符", "data": null }, "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "Conflict": { "description": "冲突（40900）", "content": { "application/json": { "example": { "code": 40900, "message": "用户名已存在", "data": null }, "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "TooManyRequests": { "description": "触发限流（42900）。按 IP 或账号维度的滑动窗口，额度由后台设置决定；请退避重试，不要换密钥硬刷。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "code": 42900, "message": "请求过于频繁，请稍后再试", "data": null } } } }, "InternalError": { "description": "服务端内部错误（50000）。响应不会回显内部细节，请凭时间点与请求 ID 报障。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "code": 50000, "message": "服务器内部错误", "data": null } } } }, "ServiceUnavailable": { "description": "服务暂不可用（50300），通常是升级/限流保护/依赖不可达。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "code": 50300, "message": "服务暂不可用，请稍后重试", "data": null } } } } } }, "security": [ { "bearer": [] } ], "paths": { "/api/health": { "get": { "tags": [ "公共" ], "summary": "健康检查", "security": [], "responses": { "200": { "description": "ok" } }, "parameters": [], "operationId": "get_api_health" } }, "/api/version": { "get": { "tags": [ "公共" ], "summary": "系统版本信息", "security": [], "responses": { "200": { "description": "版本", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": { "name": "cfapi.aog.cc", "version": "1.10.109" } } } } } }, "parameters": [], "operationId": "get_api_version" } }, "/api/openapi.json": { "get": { "tags": [ "公共" ], "summary": "本文件（机器可读接口契约）", "security": [], "responses": { "200": { "description": "OpenAPI 3.1 JSON" } }, "parameters": [], "operationId": "get_api_openapi_json" } }, "/api/docs": { "get": { "tags": [ "公共" ], "summary": "Swagger UI 可视化文档页", "security": [], "responses": { "200": { "description": "HTML" } }, "parameters": [], "operationId": "get_api_docs" } }, "/api/auth/login": { "post": { "tags": [ "认证" ], "summary": "登录获取 token", "security": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginReq" }, "example": { "username": "dev_user", "password": "your-password" } } } }, "responses": { "200": { "description": "成功", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": { "token": "eyJ...", "user": { "id": 1, "username": "admin", "is_super": 1 }, "permissions": [ "dashboard.view" ] } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" } }, "parameters": [], "operationId": "post_api_auth_login" } }, "/api/auth/logout": { "post": { "tags": [ "认证" ], "summary": "退出登录（客户端丢弃 token 即可）", "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "operationId": "post_api_auth_logout" } }, "/api/auth/profile": { "get": { "tags": [ "认证" ], "summary": "当前登录账号与权限", "responses": { "200": { "description": "ok", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": { "user": { "id": 1, "username": "admin" }, "permissions": [ "dashboard.view" ], "role_ids": [ 1 ] } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "operationId": "get_api_auth_profile" }, "put": { "tags": [ "认证登录" ], "summary": "认证登录：更新个人资料", "description": "更新当前账号资料。昵称/邮箱/电话可选，用户名变更需未被占用。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateProfileReq" } } } }, "parameters": [], "operationId": "put_api_auth_profile" } }, "/api/auth/change-password": { "post": { "tags": [ "认证" ], "summary": "修改当前账号密码", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "old_password": { "type": "string" }, "new_password": { "type": "string" } } } } } }, "responses": { "200": { "description": "ok" }, "400": { "$ref": "#/components/responses/BadRequest" } }, "parameters": [], "operationId": "post_api_auth_change_password" } }, "/api/dashboard/summary": { "get": { "tags": [ "仪表盘" ], "summary": "统计概览（需 dashboard.view）", "responses": { "200": { "description": "ok" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "operationId": "get_api_dashboard_summary" } }, "/api/admin/users": { "get": { "tags": [ "后台账号" ], "summary": "账号列表（分页+关键词，需 admin.view）", "parameters": [ { "name": "page", "in": "query", "schema": { "type": "integer" }, "example": 1 }, { "name": "page_size", "in": "query", "schema": { "type": "integer" }, "example": 20 }, { "name": "keyword", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "get_api_admin_users" }, "post": { "tags": [ "后台账号" ], "summary": "新建账号（需 admin.manage）", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "username": { "type": "string" }, "password": { "type": "string" }, "nickname": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "department_id": { "type": "integer" }, "role_ids": { "type": "array", "items": { "type": "integer" } } } } } } }, "responses": { "200": { "description": "ok" }, "409": { "$ref": "#/components/responses/Conflict" } }, "parameters": [], "operationId": "post_api_admin_users" } }, "/api/admin/users/{id}": { "get": { "tags": [ "后台账号" ], "summary": "获取单个账号详情（需 admin.view）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok；data: { user, role_ids }" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "get_api_admin_users_id" }, "put": { "tags": [ "后台账号" ], "summary": "更新账号（需 admin.manage）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "put_api_admin_users_id" }, "delete": { "tags": [ "后台账号" ], "summary": "删除账号（需 admin.manage，不可删自己）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "delete_api_admin_users_id" } }, "/api/admin/users/{id}/status": { "put": { "tags": [ "后台账号" ], "summary": "启用/禁用账号（不可操作自己）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "enum": [ 0, 1 ] } } } } } }, "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "put_api_admin_users_id_status" } }, "/api/admin/users/{id}/password": { "put": { "tags": [ "后台账号" ], "summary": "重置账号密码（需 admin.manage）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "password": { "type": "string" } } } } } }, "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "put_api_admin_users_id_password" } }, "/api/admin/users/{id}/roles": { "get": { "tags": [ "后台账号" ], "summary": "获取账号角色", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "get_api_admin_users_id_roles" }, "put": { "tags": [ "后台账号" ], "summary": "分配账号角色", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "role_ids": { "type": "array", "items": { "type": "integer" } } } } } } }, "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "put_api_admin_users_id_roles" } }, "/api/rbac/roles": { "get": { "tags": [ "角色权限" ], "summary": "角色列表（需 role.view）", "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "operationId": "get_api_rbac_roles" }, "post": { "tags": [ "角色权限" ], "summary": "新建角色（需 role.manage）", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "description": { "type": "string" } } } } } }, "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "operationId": "post_api_rbac_roles" } }, "/api/rbac/roles/{id}": { "get": { "tags": [ "角色权限" ], "summary": "获取单个角色详情（需 role.view）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok；data: { role, permission_ids }" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "get_api_rbac_roles_id" }, "put": { "tags": [ "角色权限" ], "summary": "更新角色（super_admin 不可改，需 role.manage）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "put_api_rbac_roles_id" }, "delete": { "tags": [ "角色权限" ], "summary": "删除角色（super_admin 不可删，需 role.manage）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "delete_api_rbac_roles_id" } }, "/api/rbac/roles/{id}/permissions": { "get": { "tags": [ "角色权限" ], "summary": "角色权限", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "get_api_rbac_roles_id_permissions" }, "put": { "tags": [ "角色权限" ], "summary": "分配角色权限", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "permission_ids": { "type": "array", "items": { "type": "integer" } } } } } } }, "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "put_api_rbac_roles_id_permissions" } }, "/api/rbac/permissions": { "get": { "tags": [ "角色权限" ], "summary": "权限清单（需 perm.view）", "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "operationId": "get_api_rbac_permissions" } }, "/api/rbac/departments": { "get": { "tags": [ "部门" ], "summary": "部门列表（需 dept.view）", "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "operationId": "get_api_rbac_departments" }, "post": { "tags": [ "部门" ], "summary": "新建部门（需 dept.manage）", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "parent_id": { "type": "integer" }, "name": { "type": "string" }, "sort": { "type": "integer" } } } } } }, "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "operationId": "post_api_rbac_departments" } }, "/api/rbac/departments/{id}": { "put": { "tags": [ "部门" ], "summary": "更新部门（需 dept.manage）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "put_api_rbac_departments_id" }, "delete": { "tags": [ "部门" ], "summary": "删除部门（默认部门/有下属则拒绝，需 dept.manage）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok" }, "409": { "$ref": "#/components/responses/Conflict" } }, "operationId": "delete_api_rbac_departments_id" } }, "/api/users": { "get": { "tags": [ "业务用户" ], "summary": "业务用户列表（分页+关键词，需 user.view）", "parameters": [ { "name": "page", "in": "query", "schema": { "type": "integer" } }, { "name": "page_size", "in": "query", "schema": { "type": "integer" } }, { "name": "keyword", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "get_api_users" }, "post": { "tags": [ "业务用户" ], "summary": "新建业务用户（需 user.manage）", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "username": { "type": "string" }, "password": { "type": "string" }, "nickname": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" } } } } } }, "responses": { "200": { "description": "ok" }, "409": { "$ref": "#/components/responses/Conflict" } }, "parameters": [], "operationId": "post_api_users" } }, "/api/users/{id}": { "get": { "tags": [ "业务用户" ], "summary": "获取单个业务用户详情（需 user.view）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok；data: { user }" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "get_api_users_id" }, "put": { "tags": [ "业务用户" ], "summary": "更新业务用户（需 user.manage）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "put_api_users_id" }, "delete": { "tags": [ "业务用户" ], "summary": "删除业务用户（需 user.manage）", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "delete_api_users_id" } }, "/api/users/{id}/status": { "put": { "tags": [ "业务用户" ], "summary": "启用/禁用业务用户", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "enum": [ 0, 1 ] } } } } } }, "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "put_api_users_id_status" } }, "/api/users/{id}/password": { "put": { "tags": [ "业务用户" ], "summary": "重置业务用户密码", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "password": { "type": "string" } } } } } }, "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "operationId": "put_api_users_id_password" } }, "/api/app/register": { "post": { "tags": [ "业务用户" ], "summary": "开放注册（受 ALLOW_APP_REGISTER 开关控制）", "security": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "username": { "type": "string" }, "password": { "type": "string" }, "nickname": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" } } }, "example": { "username": "dev_user", "password": "your-password", "nickname": "开发者", "email": "dev@example.com" } } } }, "responses": { "200": { "description": "ok" }, "409": { "$ref": "#/components/responses/Conflict" } }, "parameters": [], "operationId": "post_api_app_register" } }, "/api/plugins": { "get": { "tags": [ "插件" ], "summary": "插件列表（需 plugin.view）", "responses": { "200": { "description": "ok", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": [ { "id": 1, "code": "demo", "name": "示例", "ptype": "local", "status": 1 } ] } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "operationId": "get_api_plugins" }, "post": { "tags": [ "插件" ], "summary": "注册/更新插件（需 plugin.manage），body 为 PluginManifest", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginManifest" } } } }, "responses": { "200": { "description": "ok" }, "400": { "$ref": "#/components/responses/BadRequest" } }, "parameters": [], "x-required-permission": "plugin.manage", "operationId": "post_api_plugins" } }, "/api/plugins/upload": { "post": { "tags": [ "插件" ], "summary": "后台上传插件 zip 包（需 plugin.manage）。Query ?code={code}，Body 为 application/zip 原始二进制。自动解压到 /plugins/{code}/ 并读取 plugin.json 注册。", "parameters": [ { "name": "code", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ok" }, "400": { "$ref": "#/components/responses/BadRequest" } }, "x-required-permission": "plugin.manage", "operationId": "post_api_plugins_upload" } }, "/api/plugins/scan": { "post": { "tags": [ "插件" ], "summary": "扫描插件目录，把已解压未注册的插件批量注册（需 plugin.manage）", "responses": { "200": { "description": "ok", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": { "installed": 1, "skipped": [] } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "x-required-permission": "plugin.manage", "operationId": "post_api_plugins_scan" } }, "/api/plugins/market": { "get": { "tags": [ "插件" ], "summary": "插件市场目录（需 plugin.view）。返回可一键安装的插件清单(items)，source=builtin 表示使用内置目录、remote 表示来自 PLUGIN_MARKET_URL 配置的市场服务。", "responses": { "200": { "description": "ok", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": { "items": [ { "code": "demo_remote", "name": "示例·远程插件", "version": "1.10.109", "type": "remote", "base_url": "https://cfapi.aog.cc", "description": "其他服务器 API" } ], "source": "builtin" } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "operationId": "get_api_plugins_market" } }, "/api/plugins/market/install": { "post": { "tags": [ "插件" ], "summary": "从插件市场一键安装（需 plugin.manage）。remote 类型零文件操作瞬时登记 base_url；local 类型从市场策展 download_url 拉包落地。", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketInstallReq" } } } }, "responses": { "200": { "description": "ok" }, "400": { "$ref": "#/components/responses/BadRequest" }, "404": { "$ref": "#/components/responses/Conflict" } }, "parameters": [], "operationId": "post_api_plugins_market_install" } }, "/api/plugins/{code}": { "get": { "tags": [ "插件" ], "summary": "插件详情（需 plugin.view）", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ok", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": { "code": "demo", "name": "示例", "ptype": "local", "manifest": "{\"code\":\"demo\",\"menu\":{\"title\":\"示例\"}}" } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "x-required-permission": "plugin.view", "operationId": "get_api_plugins_code" }, "delete": { "tags": [ "插件" ], "summary": "卸载插件（需 plugin.manage，local 会清理本地目录）", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "x-required-permission": "plugin.manage", "operationId": "delete_api_plugins_code" } }, "/api/plugins/{code}/enable": { "post": { "tags": [ "插件" ], "summary": "启用插件（需 plugin.manage）", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "x-required-permission": "plugin.manage", "operationId": "post_api_plugins_code_enable" } }, "/api/plugins/{code}/disable": { "post": { "tags": [ "插件" ], "summary": "停用插件（需 plugin.manage）", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ok" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "x-required-permission": "plugin.manage", "operationId": "post_api_plugins_code_disable" } }, "/api/plugins/{code}/proxy/{tail}": { "get": { "tags": [ "插件" ], "summary": "插件鉴权网关转发（需 plugin.view）。使用 X-Platform-Signature 按插件专属密钥签名转发到 base_url。", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tail", "in": "path", "required": true, "schema": { "type": "string" }, "description": "转发到插件后端的子路径" } ], "responses": { "200": { "description": "插件响应" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "x-required-permission": "plugin.view", "description": "平台鉴权反向代理，仅 remote + base_url 可用。读方法需要 plugin.view，写方法需要 plugin.manage。平台注入 X-Platform-Signature / X-Platform-Caller-Signature（按插件派生密钥，推荐校验）、旧 X-Platform-Token（平台全局密钥，仅为兼容，外部插件不应依赖）以及租户/调用者头；同时剥离调用者 Authorization/Cookie/x-api-key/x-auth-token。响应上限 16 MB，默认超时 15 秒。", "operationId": "get_api_plugins_code_proxy_tail" }, "post": { "tags": [ "插件" ], "summary": "插件 API 转发(POST)", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tail", "in": "path", "required": true, "schema": { "type": "string" }, "description": "转发到插件后端的子路径" } ], "responses": { "200": { "description": "插件响应" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "x-required-permission": "plugin.manage", "description": "平台鉴权反向代理，仅 remote + base_url 可用。读方法需要 plugin.view，写方法需要 plugin.manage。平台注入 X-Platform-Signature / X-Platform-Caller-Signature（按插件派生密钥，推荐校验）、旧 X-Platform-Token（平台全局密钥，仅为兼容，外部插件不应依赖）以及租户/调用者头；同时剥离调用者 Authorization/Cookie/x-api-key/x-auth-token。响应上限 16 MB，默认超时 15 秒。", "operationId": "post_api_plugins_code_proxy_tail" }, "put": { "tags": [ "插件" ], "summary": "插件 API 转发(PUT)", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tail", "in": "path", "required": true, "schema": { "type": "string" }, "description": "转发到插件后端的子路径" } ], "responses": { "200": { "description": "插件响应" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "x-required-permission": "plugin.manage", "description": "平台鉴权反向代理，仅 remote + base_url 可用。读方法需要 plugin.view，写方法需要 plugin.manage。平台注入 X-Platform-Signature / X-Platform-Caller-Signature（按插件派生密钥，推荐校验）、旧 X-Platform-Token（平台全局密钥，仅为兼容，外部插件不应依赖）以及租户/调用者头；同时剥离调用者 Authorization/Cookie/x-api-key/x-auth-token。响应上限 16 MB，默认超时 15 秒。", "operationId": "put_api_plugins_code_proxy_tail" }, "delete": { "tags": [ "插件" ], "summary": "插件 API 转发(DELETE)", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tail", "in": "path", "required": true, "schema": { "type": "string" }, "description": "转发到插件后端的子路径" } ], "responses": { "200": { "description": "插件响应" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "x-required-permission": "plugin.manage", "description": "平台鉴权反向代理，仅 remote + base_url 可用。读方法需要 plugin.view，写方法需要 plugin.manage。平台注入 X-Platform-Signature / X-Platform-Caller-Signature（按插件派生密钥，推荐校验）、旧 X-Platform-Token（平台全局密钥，仅为兼容，外部插件不应依赖）以及租户/调用者头；同时剥离调用者 Authorization/Cookie/x-api-key/x-auth-token。响应上限 16 MB，默认超时 15 秒。", "operationId": "delete_api_plugins_code_proxy_tail" } }, "/api/system/info": { "get": { "tags": [ "系统" ], "summary": "版本与升级状态（需 system.view）", "responses": { "200": { "description": "ok", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": { "app_version": "1.0.0", "upgrade_running": false, "last_upgrade_ok": true } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "operationId": "get_api_system_info" } }, "/api/system/upgrade": { "post": { "tags": [ "系统" ], "summary": "后台一键无损升级（需 system.manage）。触发 upgrade.sh：备份→编译→平滑重启→健康检查→失败回滚。", "security": [ { "bearer": [] } ], "responses": { "200": { "description": "已启动" }, "409": { "$ref": "#/components/responses/Conflict" } }, "parameters": [], "operationId": "post_api_system_upgrade" } }, "/api/system/upgrade/status": { "get": { "tags": [ "系统" ], "summary": "升级进度/结果（需 system.view）", "responses": { "200": { "description": "ok", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": { "running": false, "last_ok": true, "updated_at": 1752595200, "output": "..." } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" } }, "parameters": [], "operationId": "get_api_system_upgrade_status" } }, "/plugins/{code}/{tail}": { "get": { "tags": [ "插件" ], "summary": "本地插件前端静态资源（无需鉴权，由后端直出）", "description": "local 插件解压到 /plugins/{code}/ 后，其前端由此直出。入口示例：/plugins/{code}/index.html。Nginx 兜底反代到本服务，无需修改 vhost 配置。", "security": [], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "插件 code（小写字母/数字/下划线）" }, { "name": "tail", "in": "path", "required": true, "schema": { "type": "string" }, "description": "资源相对路径，如 index.html 或 assets/app.js" } ], "responses": { "200": { "description": "静态资源（按扩展名设置 Content-Type，Cache-Control: public, max-age=604800）" }, "404": { "$ref": "#/components/responses/Conflict" } }, "operationId": "get_plugins_code_tail" } }, "/api/_storage": { "get": { "tags": [ "插件对象存储（面向插件）" ], "summary": "插件对象存储（面向插件）：查询列表", "description": "由源码路由表自动生成。真实挂载路径：`/api/_storage`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_storage" }, "post": { "tags": [ "插件对象存储（面向插件）" ], "summary": "插件对象存储（面向插件）：创建", "description": "由源码路由表自动生成。真实挂载路径：`/api/_storage`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_storage" } }, "/api/_storage/s/{bucket}/{token}": { "get": { "tags": [ "插件对象存储（面向插件）" ], "summary": "bucket：按 token 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/_storage/s/{bucket}/{token}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "bucket", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：bucket" }, { "name": "token", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：token" } ], "operationId": "get_api_storage_s_bucket_token" } }, "/api/_storage/shares": { "post": { "tags": [ "插件对象存储（面向插件）" ], "summary": "插件对象存储（面向插件）：创建 shares", "description": "由源码路由表自动生成。真实挂载路径：`/api/_storage/shares`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "bucket": { "type": "string" }, "object_key": { "type": "string" }, "expires_hours": { "type": "integer" }, "max_downloads": { "type": "integer" }, "password": { "type": "string" } }, "additionalProperties": true, "required": [ "bucket", "object_key" ], "description": "由源码结构体 `CreateShareReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "CreateShareReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_storage_shares", "x-schema-source": "derived-from-struct" } }, "/api/_storage/{bucket}": { "delete": { "tags": [ "插件对象存储（面向插件）" ], "summary": "插件对象存储（面向插件）：按 bucket 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/_storage/{bucket}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "bucket", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：bucket" } ], "operationId": "delete_api_storage_bucket" }, "get": { "tags": [ "插件对象存储（面向插件）" ], "summary": "插件对象存储（面向插件）：按 bucket 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/_storage/{bucket}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "bucket", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：bucket" } ], "operationId": "get_api_storage_bucket" } }, "/api/admin/menu": { "get": { "tags": [ "后台用户管理" ], "summary": "后台用户管理：查询菜单", "description": "由源码路由表自动生成。真实挂载路径：`/api/admin/menu`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_admin_menu" }, "put": { "tags": [ "后台用户管理" ], "summary": "后台用户管理：更新菜单", "description": "由源码路由表自动生成。真实挂载路径：`/api/admin/menu`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "menu_json": { "type": "string" } }, "additionalProperties": true, "required": [ "menu_json" ], "description": "由源码结构体 `UpdateReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "UpdateReq", "x-struct-definitions": 4 } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "put_api_admin_menu", "x-schema-source": "derived-from-struct" } }, "/api/anthropic/v1/messages": { "post": { "tags": [ "Anthropic 兼容接口" ], "summary": "Anthropic 兼容接口：创建消息", "description": "Anthropic Messages 兼容入口，按用户限流与计量；插件内调用优先使用 /api/plugins/{code}/ai/chat。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnthropicMessagesReq" } } } }, "parameters": [], "operationId": "post_api_anthropic_v1_messages" } }, "/api/api-keys": { "get": { "tags": [ "接口密钥" ], "summary": "接口密钥：查询列表", "description": "由源码路由表自动生成。真实挂载路径：`/api/api-keys`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_api_keys" }, "post": { "tags": [ "接口密钥" ], "summary": "接口密钥：创建", "description": "签发 API Key。明文密钥只在创建响应出现一次；scope 与层级均受归属账号上限约束。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateApiKeyReq" } } } }, "parameters": [], "operationId": "post_api_api_keys" } }, "/api/api-keys/{key_id}": { "delete": { "tags": [ "接口密钥" ], "summary": "接口密钥：按 key_id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/api-keys/{key_id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "key_id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：key_id" } ], "operationId": "delete_api_api_keys_key_id" } }, "/api/auth/captcha": { "get": { "tags": [ "认证登录" ], "summary": "认证登录：查询图形验证码", "description": "由源码路由表自动生成。真实挂载路径：`/api/auth/captcha`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_auth_captcha" } }, "/api/auth/reset-default": { "post": { "tags": [ "认证登录" ], "summary": "认证登录：创建 reset default", "description": "由源码路由表自动生成。真实挂载路径：`/api/auth/reset-default`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_auth_reset_default" } }, "/api/backups": { "get": { "tags": [ "备份与恢复" ], "summary": "备份与恢复：查询列表", "description": "由源码路由表自动生成。真实挂载路径：`/api/backups`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_backups" }, "post": { "tags": [ "备份与恢复" ], "summary": "备份与恢复：创建", "description": "由源码路由表自动生成。真实挂载路径：`/api/backups`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" } }, "additionalProperties": true, "description": "由源码结构体 `BackupCreateReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "BackupCreateReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_backups", "x-schema-source": "derived-from-struct" } }, "/api/backups/batch-delete": { "post": { "tags": [ "备份与恢复" ], "summary": "备份与恢复：创建 batch delete", "description": "由源码路由表自动生成。真实挂载路径：`/api/backups/batch-delete`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true, "required": [ "ids" ], "description": "由源码结构体 `BatchDeleteReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "BatchDeleteReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_backups_batch_delete", "x-schema-source": "derived-from-struct" } }, "/api/backups/delete": { "post": { "tags": [ "备份与恢复" ], "summary": "备份与恢复：创建 delete", "description": "由源码路由表自动生成。真实挂载路径：`/api/backups/delete`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" } }, "additionalProperties": true, "required": [ "id" ], "description": "由源码结构体 `DeleteReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "DeleteReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_backups_delete", "x-schema-source": "derived-from-struct" } }, "/api/backups/{id}/restore": { "post": { "tags": [ "备份与恢复" ], "summary": "备份与恢复：执行恢复（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/backups/{id}/restore`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_backups_id_restore" } }, "/api/billing/invoices": { "get": { "tags": [ "计费与账单" ], "summary": "计费与账单：查询发票", "description": "由源码路由表自动生成。真实挂载路径：`/api/billing/invoices`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_billing_invoices" } }, "/api/billing/plans": { "get": { "tags": [ "计费与账单" ], "summary": "计费与账单：查询 plans", "description": "由源码路由表自动生成。真实挂载路径：`/api/billing/plans`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_billing_plans" }, "post": { "tags": [ "计费与账单" ], "summary": "计费与账单：创建 plans", "description": "由源码路由表自动生成。真实挂载路径：`/api/billing/plans`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "price_cents": { "type": "integer" }, "interval_type": { "type": "string" }, "billing_type": { "type": "string" }, "unit_price_cents": { "type": "integer" }, "unit": { "type": "string" }, "trial_days": { "type": "integer" }, "features_json": { "type": "string" } }, "additionalProperties": true, "required": [ "name", "code", "price_cents" ], "description": "由源码结构体 `PlanReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "PlanReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_billing_plans", "x-schema-source": "derived-from-struct" } }, "/api/billing/plans/{id}": { "delete": { "tags": [ "计费与账单" ], "summary": "plans：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/billing/plans/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_billing_plans_id" }, "put": { "tags": [ "计费与账单" ], "summary": "plans：按 id 更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/billing/plans/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "price_cents": { "type": "integer" }, "interval_type": { "type": "string" }, "billing_type": { "type": "string" }, "unit_price_cents": { "type": "integer" }, "unit": { "type": "string" }, "trial_days": { "type": "integer" }, "features_json": { "type": "string" } }, "additionalProperties": true, "required": [ "name", "code", "price_cents" ], "description": "由源码结构体 `PlanReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "PlanReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "put_api_billing_plans_id", "x-schema-source": "derived-from-struct" } }, "/api/billing/revenue": { "get": { "tags": [ "计费与账单" ], "summary": "计费与账单：查询收入", "description": "由源码路由表自动生成。真实挂载路径：`/api/billing/revenue`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_billing_revenue" } }, "/api/billing/subscriptions": { "get": { "tags": [ "计费与账单" ], "summary": "计费与账单：查询订阅", "description": "由源码路由表自动生成。真实挂载路径：`/api/billing/subscriptions`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_billing_subscriptions" } }, "/api/build/cdn": { "get": { "tags": [ "构建与分发" ], "summary": "构建与分发：查询 cdn", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/cdn`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_build_cdn" }, "put": { "tags": [ "构建与分发" ], "summary": "构建与分发：更新 cdn", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/cdn`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "provider": { "type": "string" }, "name": { "type": "string" }, "api_base": { "type": "string" }, "access_key": { "type": "string" }, "secret_key": { "type": "string" }, "domain": { "type": "string" }, "enabled": { "type": "integer" } }, "additionalProperties": true, "required": [ "name" ], "description": "由源码结构体 `CdnReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "CdnReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "put_api_build_cdn", "x-schema-source": "derived-from-struct" } }, "/api/build/cdn/purge": { "post": { "tags": [ "构建与分发" ], "summary": "构建与分发：创建 purge", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/cdn/purge`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_build_cdn_purge" } }, "/api/build/certs": { "get": { "tags": [ "构建与分发" ], "summary": "构建与分发：查询证书", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/certs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_build_certs" }, "post": { "tags": [ "构建与分发" ], "summary": "构建与分发：创建证书", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/certs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "platform": { "type": "string" }, "cert_name": { "type": "string" }, "cert_path": { "type": "string" }, "password": { "type": "string" } }, "additionalProperties": true, "required": [ "cert_name" ], "description": "由源码结构体 `CertReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "CertReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_build_certs", "x-schema-source": "derived-from-struct" } }, "/api/build/certs/{id}": { "delete": { "tags": [ "构建与分发" ], "summary": "证书：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/certs/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_build_certs_id" } }, "/api/build/jobs": { "get": { "tags": [ "构建与分发" ], "summary": "构建与分发：查询任务", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/jobs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_build_jobs" } }, "/api/build/jobs/{id}": { "get": { "tags": [ "构建与分发" ], "summary": "任务：按 id 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/jobs/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_build_jobs_id" } }, "/api/build/ota": { "post": { "tags": [ "构建与分发" ], "summary": "构建与分发：创建 ota", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/ota`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "version": { "type": "string" }, "platform": { "type": "string" }, "manifest_json": { "type": "string" }, "url": { "type": "string" } }, "additionalProperties": true, "required": [ "plugin_code", "version" ], "description": "由源码结构体 `OtaReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "OtaReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_build_ota", "x-schema-source": "derived-from-struct" } }, "/api/build/ota/{plugin_code}": { "get": { "tags": [ "构建与分发" ], "summary": "ota：按 plugin_code 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/ota/{plugin_code}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "plugin_code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：plugin_code" } ], "operationId": "get_api_build_ota_plugin_code" } }, "/api/build/overview": { "get": { "tags": [ "构建与分发" ], "summary": "构建与分发：查询概览", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/overview`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_build_overview" } }, "/api/build/sdk": { "post": { "tags": [ "构建与分发" ], "summary": "构建与分发：创建 sdk", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/sdk`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "language": { "type": "string" } }, "additionalProperties": true, "required": [ "plugin_code" ], "description": "由源码结构体 `SdkReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "SdkReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_build_sdk", "x-schema-source": "derived-from-struct" } }, "/api/build/sdk/{id}": { "get": { "tags": [ "构建与分发" ], "summary": "sdk：按 id 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/sdk/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_build_sdk_id" } }, "/api/build/targets": { "get": { "tags": [ "构建与分发" ], "summary": "构建与分发：查询目标", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/targets`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_build_targets" }, "post": { "tags": [ "构建与分发" ], "summary": "构建与分发：创建目标", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/targets`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "target_type": { "type": "string" }, "name": { "type": "string" }, "build_command": { "type": "string" }, "output_dir": { "type": "string" }, "sign_required": { "type": "integer" }, "enabled": { "type": "integer" } }, "additionalProperties": true, "required": [ "name", "build_command" ], "description": "由源码结构体 `TargetReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "TargetReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_build_targets", "x-schema-source": "derived-from-struct" } }, "/api/build/targets/{id}": { "delete": { "tags": [ "构建与分发" ], "summary": "目标：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/targets/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_build_targets_id" }, "put": { "tags": [ "构建与分发" ], "summary": "目标：按 id 更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/targets/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "target_type": { "type": "string" }, "name": { "type": "string" }, "build_command": { "type": "string" }, "output_dir": { "type": "string" }, "sign_required": { "type": "integer" }, "enabled": { "type": "integer" } }, "additionalProperties": true, "required": [ "name", "build_command" ], "description": "由源码结构体 `TargetReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "TargetReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "put_api_build_targets_id", "x-schema-source": "derived-from-struct" } }, "/api/build/trigger": { "post": { "tags": [ "构建与分发" ], "summary": "构建与分发：创建 trigger", "description": "由源码路由表自动生成。真实挂载路径：`/api/build/trigger`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "target_id": { "type": "integer" }, "plugin_code": { "type": "string" } }, "additionalProperties": true, "required": [ "target_id" ], "description": "由源码结构体 `TriggerReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "TriggerReq", "x-struct-definitions": 2 } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_build_trigger", "x-schema-source": "derived-from-struct" } }, "/api/cicd/config": { "get": { "tags": [ "持续集成部署" ], "summary": "持续集成部署：查询配置", "description": "由源码路由表自动生成。真实挂载路径：`/api/cicd/config`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_cicd_config" }, "put": { "tags": [ "持续集成部署" ], "summary": "持续集成部署：更新配置", "description": "由源码路由表自动生成。真实挂载路径：`/api/cicd/config`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "repo_url": { "type": "string" }, "branch": { "type": "string" }, "webhook_secret": { "type": "string" }, "clone_dir": { "type": "string" }, "frontend_build_cmd": { "type": "string" }, "backend_build_cmd": { "type": "string" }, "deploy_cmd": { "type": "string" } }, "additionalProperties": true, "description": "由源码结构体 `CicdConfigUpdate` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "CicdConfigUpdate" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "put_api_cicd_config", "x-schema-source": "derived-from-struct" } }, "/api/cicd/runs": { "get": { "tags": [ "持续集成部署" ], "summary": "持续集成部署：查询运行记录", "description": "由源码路由表自动生成。真实挂载路径：`/api/cicd/runs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_cicd_runs" } }, "/api/cicd/runs/{id}": { "get": { "tags": [ "持续集成部署" ], "summary": "运行记录：按 id 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/cicd/runs/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_cicd_runs_id" } }, "/api/cicd/trigger": { "post": { "tags": [ "持续集成部署" ], "summary": "持续集成部署：创建 trigger", "description": "由源码路由表自动生成。真实挂载路径：`/api/cicd/trigger`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "target_id": { "type": "integer" }, "plugin_code": { "type": "string" } }, "additionalProperties": true, "required": [ "target_id" ], "description": "由源码结构体 `TriggerReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "TriggerReq", "x-struct-definitions": 2 } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_cicd_trigger", "x-schema-source": "derived-from-struct" } }, "/api/cicd/webhook": { "post": { "tags": [ "持续集成部署" ], "summary": "持续集成部署：创建 webhook", "description": "由源码路由表自动生成。真实挂载路径：`/api/cicd/webhook`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_cicd_webhook" } }, "/api/cleanup": { "get": { "tags": [ "数据清理" ], "summary": "数据清理：查询列表", "description": "由源码路由表自动生成。真实挂载路径：`/api/cleanup`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_cleanup" }, "post": { "tags": [ "数据清理" ], "summary": "数据清理：创建", "description": "由源码路由表自动生成。真实挂载路径：`/api/cleanup`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_cleanup" } }, "/api/cleanup/trash": { "get": { "tags": [ "数据清理" ], "summary": "数据清理：查询回收站", "description": "由源码路由表自动生成。真实挂载路径：`/api/cleanup/trash`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_cleanup_trash" } }, "/api/cleanup/trash/empty": { "post": { "tags": [ "数据清理" ], "summary": "数据清理：创建 empty", "description": "由源码路由表自动生成。真实挂载路径：`/api/cleanup/trash/empty`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" } }, "additionalProperties": true, "description": "由源码结构体 `TrashOpReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "TrashOpReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_cleanup_trash_empty", "x-schema-source": "derived-from-struct" } }, "/api/cleanup/trash/restore": { "post": { "tags": [ "数据清理" ], "summary": "数据清理：执行恢复", "description": "由源码路由表自动生成。真实挂载路径：`/api/cleanup/trash/restore`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" } }, "additionalProperties": true, "description": "由源码结构体 `TrashOpReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "TrashOpReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_cleanup_trash_restore", "x-schema-source": "derived-from-struct" } }, "/api/cloud-functions/create": { "post": { "tags": [ "云函数" ], "summary": "云函数：创建 create", "description": "由源码路由表自动生成。真实挂载路径：`/api/cloud-functions/create`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "name": { "type": "string" }, "runtime": { "type": "string" }, "code": { "type": "string" }, "handler": { "type": "string" }, "trigger_type": { "type": "string" }, "trigger_config": { "type": "string" }, "timeout_ms": { "type": "integer" }, "memory_mb": { "type": "integer" }, "env_vars": { "type": "string" } }, "additionalProperties": true, "required": [ "plugin_code", "name", "code" ], "description": "由源码结构体 `CloudFnReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "CloudFnReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_cloud_functions_create", "x-schema-source": "derived-from-struct" } }, "/api/cloud-functions/list": { "get": { "tags": [ "云函数" ], "summary": "云函数：查询列表", "description": "由源码路由表自动生成。真实挂载路径：`/api/cloud-functions/list`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_cloud_functions_list" } }, "/api/cloud-functions/overview": { "get": { "tags": [ "云函数" ], "summary": "云函数：查询概览", "description": "由源码路由表自动生成。真实挂载路径：`/api/cloud-functions/overview`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_cloud_functions_overview" } }, "/api/cloud-functions/{id}": { "delete": { "tags": [ "云函数" ], "summary": "云函数：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/cloud-functions/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_cloud_functions_id" } }, "/api/cloud-functions/{id}/execute": { "post": { "tags": [ "云函数" ], "summary": "云函数：执行执行（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/cloud-functions/{id}/execute`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "payload": { "description": "任意 JSON" } }, "additionalProperties": true, "description": "由源码结构体 `CloudFnTestReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "CloudFnTestReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_cloud_functions_id_execute", "x-schema-source": "derived-from-struct" } }, "/api/cloud-functions/{id}/logs": { "get": { "tags": [ "云函数" ], "summary": "云函数：查询日志（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/cloud-functions/{id}/logs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_cloud_functions_id_logs" } }, "/api/console/menu": { "get": { "tags": [ "控制台配置" ], "summary": "控制台配置：查询菜单", "description": "由源码路由表自动生成。真实挂载路径：`/api/console/menu`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_console_menu" } }, "/api/console/settings": { "get": { "tags": [ "控制台配置" ], "summary": "控制台配置：查询设置", "description": "由源码路由表自动生成。真实挂载路径：`/api/console/settings`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_console_settings" }, "put": { "tags": [ "控制台配置" ], "summary": "控制台配置：更新设置", "description": "由源码路由表自动生成。真实挂载路径：`/api/console/settings`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string" }, "menu_json": { "type": "string" }, "logo_type": { "type": "string" }, "logo_text_config": { "description": "任意 JSON" }, "logo_image_config": { "description": "任意 JSON" }, "logo": { "description": "任意 JSON" }, "logo_json": { "type": "string" }, "site_json": { "description": "任意 JSON" } }, "additionalProperties": true, "description": "由源码结构体 `UpdateReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "UpdateReq", "x-struct-definitions": 4 } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "put_api_console_settings", "x-schema-source": "derived-from-struct" } }, "/api/credit/overview": { "get": { "tags": [ "信用评分" ], "summary": "信用评分：查询概览", "description": "由源码路由表自动生成。真实挂载路径：`/api/credit/overview`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_credit_overview" } }, "/api/credit/{developer}": { "get": { "tags": [ "信用评分" ], "summary": "信用评分：按 developer 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/credit/{developer}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "developer", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：developer" } ], "operationId": "get_api_credit_developer" } }, "/api/db/query": { "post": { "tags": [ "数据库管理" ], "summary": "数据库管理：创建查询", "description": "由源码路由表自动生成。真实挂载路径：`/api/db/query`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "sql": { "type": "string" }, "limit": { "type": "integer" } }, "additionalProperties": true, "required": [ "sql" ], "description": "由源码结构体 `DbQueryReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "DbQueryReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_db_query", "x-schema-source": "derived-from-struct" } }, "/api/db/search": { "post": { "tags": [ "数据库管理" ], "summary": "数据库管理：创建搜索", "description": "由源码路由表自动生成。真实挂载路径：`/api/db/search`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keyword": { "type": "string" }, "limit": { "type": "integer" } }, "additionalProperties": true, "required": [ "keyword" ], "description": "由源码结构体 `DbSearchReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "DbSearchReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_db_search", "x-schema-source": "derived-from-struct" } }, "/api/db/tables": { "get": { "tags": [ "数据库管理" ], "summary": "数据库管理：查询数据表", "description": "由源码路由表自动生成。真实挂载路径：`/api/db/tables`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_db_tables" } }, "/api/db/tables/{table}": { "get": { "tags": [ "数据库管理" ], "summary": "数据表：按 table 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/db/tables/{table}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "table", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：table" } ], "operationId": "get_api_db_tables_table" } }, "/api/events": { "get": { "tags": [ "事件总线" ], "summary": "事件总线：查询列表", "description": "由源码路由表自动生成。真实挂载路径：`/api/events`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_events" } }, "/api/gateway/config": { "get": { "tags": [ "协议网关" ], "summary": "协议网关：查询配置", "description": "由源码路由表自动生成。真实挂载路径：`/api/gateway/config`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_gateway_config" }, "put": { "tags": [ "协议网关" ], "summary": "协议网关：更新配置", "description": "由源码路由表自动生成。真实挂载路径：`/api/gateway/config`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "repo_url": { "type": "string" }, "branch": { "type": "string" }, "webhook_secret": { "type": "string" }, "clone_dir": { "type": "string" }, "frontend_build_cmd": { "type": "string" }, "backend_build_cmd": { "type": "string" }, "deploy_cmd": { "type": "string" } }, "additionalProperties": true, "description": "由源码结构体 `CicdConfigUpdate` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "CicdConfigUpdate" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "put_api_gateway_config", "x-schema-source": "derived-from-struct" } }, "/api/gateway/status": { "get": { "tags": [ "协议网关" ], "summary": "协议网关：查询状态", "description": "由源码路由表自动生成。真实挂载路径：`/api/gateway/status`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_gateway_status" } }, "/api/health/plugins": { "get": { "tags": [ "健康检查" ], "summary": "健康检查：查询 plugins", "description": "由源码路由表自动生成。真实挂载路径：`/api/health/plugins`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_health_plugins" } }, "/api/hooks": { "get": { "tags": [ "钩子链" ], "summary": "钩子链：查询列表", "description": "由源码路由表自动生成。真实挂载路径：`/api/hooks`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_hooks" }, "post": { "tags": [ "钩子链" ], "summary": "钩子链：创建", "description": "由源码路由表自动生成。真实挂载路径：`/api/hooks`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "hook_point": { "type": "string" }, "priority": { "type": "integer" }, "enabled": { "type": "boolean" }, "target_url": { "type": "string" }, "timeout_ms": { "type": "integer" } }, "additionalProperties": true, "required": [ "plugin_code", "hook_point" ], "description": "由源码结构体 `RegisterReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "RegisterReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_hooks", "x-schema-source": "derived-from-struct" } }, "/api/hooks/{id}": { "delete": { "tags": [ "钩子链" ], "summary": "钩子链：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/hooks/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_hooks_id" }, "put": { "tags": [ "钩子链" ], "summary": "钩子链：按 id 更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/hooks/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "priority": { "type": "integer" }, "enabled": { "type": "boolean" }, "target_url": { "type": "string" }, "timeout_ms": { "type": "integer" } }, "additionalProperties": true, "description": "由源码结构体 `UpdateReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "UpdateReq", "x-struct-definitions": 4 } } } }, "x-contract-status": "internal-admin-generic", "operationId": "put_api_hooks_id", "x-schema-source": "derived-from-struct" } }, "/api/hooks/{id}/test": { "post": { "tags": [ "钩子链" ], "summary": "钩子链：执行测试（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/hooks/{id}/test`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "sample": { "description": "任意 JSON" } }, "additionalProperties": true, "description": "由源码结构体 `TestReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "TestReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_hooks_id_test", "x-schema-source": "derived-from-struct" } }, "/api/hooks/{id}/toggle": { "post": { "tags": [ "钩子链" ], "summary": "钩子链：执行切换（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/hooks/{id}/toggle`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_hooks_id_toggle" } }, "/api/i18n/langs": { "get": { "tags": [ "多语言" ], "summary": "多语言：查询语言", "description": "由源码路由表自动生成。真实挂载路径：`/api/i18n/langs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_i18n_langs" } }, "/api/i18n/public": { "get": { "tags": [ "多语言" ], "summary": "多语言：查询 public", "description": "由源码路由表自动生成。真实挂载路径：`/api/i18n/public`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_i18n_public" } }, "/api/i18n/translations": { "delete": { "tags": [ "多语言" ], "summary": "多语言：删除 translations", "description": "由源码路由表自动生成。真实挂载路径：`/api/i18n/translations`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "delete_api_i18n_translations" }, "get": { "tags": [ "多语言" ], "summary": "多语言：查询 translations", "description": "由源码路由表自动生成。真实挂载路径：`/api/i18n/translations`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_i18n_translations" }, "post": { "tags": [ "多语言" ], "summary": "多语言：创建 translations", "description": "由源码路由表自动生成。真实挂载路径：`/api/i18n/translations`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "lang": { "type": "string" }, "namespace": { "type": "string" }, "key_name": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": true, "required": [ "lang", "key_name", "value" ], "description": "由源码结构体 `UpdateTransReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "UpdateTransReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_i18n_translations", "x-schema-source": "derived-from-struct" } }, "/api/i18n/translations/bulk": { "post": { "tags": [ "多语言" ], "summary": "多语言：创建 bulk", "description": "由源码路由表自动生成。真实挂载路径：`/api/i18n/translations/bulk`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "lang": { "type": "string" }, "translations": { "type": "object", "additionalProperties": { "type": "string" } } }, "additionalProperties": true, "required": [ "lang", "translations" ], "description": "由源码结构体 `BulkUpdateReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "BulkUpdateReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_i18n_translations_bulk", "x-schema-source": "derived-from-struct" } }, "/api/iam/abac-policies": { "get": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：查询 abac policies", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/abac-policies`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_iam_abac_policies" }, "post": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：创建 abac policies", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/abac-policies`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "resource": { "type": "string" }, "action": { "type": "string" }, "effect": { "type": "string" }, "conditions_json": { "type": "string" }, "priority": { "type": "integer" }, "enabled": { "type": "boolean" } }, "additionalProperties": true, "required": [ "name", "resource", "action" ], "description": "由源码结构体 `AbacPolicyReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "AbacPolicyReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_iam_abac_policies", "x-schema-source": "derived-from-struct" } }, "/api/iam/abac-policies/{id}": { "delete": { "tags": [ "身份与访问控制" ], "summary": "abac policies：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/abac-policies/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_iam_abac_policies_id" } }, "/api/iam/delegations": { "get": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：查询委派", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/delegations`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_iam_delegations" }, "post": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：创建委派", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/delegations`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "user_id": { "type": "integer" }, "scopes": { "type": "string" }, "expires_at": { "type": "string" } }, "additionalProperties": true, "required": [ "plugin_code", "user_id" ], "description": "由源码结构体 `DelegationReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "DelegationReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_iam_delegations", "x-schema-source": "derived-from-struct" } }, "/api/iam/delegations/{id}": { "delete": { "tags": [ "身份与访问控制" ], "summary": "委派：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/delegations/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_iam_delegations_id" } }, "/api/iam/federated/{id}/authorize": { "get": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：查询 authorize（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/federated/{id}/authorize`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_iam_federated_id_authorize" } }, "/api/iam/federated/{id}/callback": { "get": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：查询 callback（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/federated/{id}/callback`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_iam_federated_id_callback" } }, "/api/iam/idps": { "get": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：查询身份提供方", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/idps`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_iam_idps" }, "post": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：创建身份提供方", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/idps`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "provider_type": { "type": "string" }, "name": { "type": "string" }, "enabled": { "type": "boolean" }, "client_id": { "type": "string" }, "client_secret": { "type": "string" }, "issuer": { "type": "string" }, "authorize_url": { "type": "string" }, "token_url": { "type": "string" }, "userinfo_url": { "type": "string" }, "scopes": { "type": "string" }, "mapping_json": { "type": "string" }, "redirect_uri": { "type": "string" } }, "additionalProperties": true, "required": [ "name" ], "description": "由源码结构体 `IdpReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "IdpReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_iam_idps", "x-schema-source": "derived-from-struct" } }, "/api/iam/idps/enabled": { "get": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：查询 enabled", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/idps/enabled`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_iam_idps_enabled" } }, "/api/iam/idps/{id}": { "delete": { "tags": [ "身份与访问控制" ], "summary": "身份提供方：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/idps/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_iam_idps_id" }, "put": { "tags": [ "身份与访问控制" ], "summary": "身份提供方：按 id 更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/idps/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "provider_type": { "type": "string" }, "name": { "type": "string" }, "enabled": { "type": "boolean" }, "client_id": { "type": "string" }, "client_secret": { "type": "string" }, "issuer": { "type": "string" }, "authorize_url": { "type": "string" }, "token_url": { "type": "string" }, "userinfo_url": { "type": "string" }, "scopes": { "type": "string" }, "mapping_json": { "type": "string" }, "redirect_uri": { "type": "string" } }, "additionalProperties": true, "required": [ "name" ], "description": "由源码结构体 `IdpReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "IdpReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "put_api_iam_idps_id", "x-schema-source": "derived-from-struct" } }, "/api/iam/roles/{id}/scopes": { "get": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：查询作用域（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/roles/{id}/scopes`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_iam_roles_id_scopes" }, "put": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：更新作用域（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/roles/{id}/scopes`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "scopes": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true, "required": [ "scopes" ], "description": "由源码结构体 `RoleScopesReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "RoleScopesReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "put_api_iam_roles_id_scopes", "x-schema-source": "derived-from-struct" } }, "/api/iam/scopes": { "get": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：查询作用域", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/scopes`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_iam_scopes" }, "post": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：创建作用域", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/scopes`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "scope": { "type": "string" }, "category": { "type": "string" }, "description": { "type": "string" } }, "additionalProperties": true, "required": [ "scope" ], "description": "由源码结构体 `ScopeReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "ScopeReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_iam_scopes", "x-schema-source": "derived-from-struct" } }, "/api/iam/scopes/{id}": { "delete": { "tags": [ "身份与访问控制" ], "summary": "作用域：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/scopes/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_iam_scopes_id" } }, "/api/iam/tenants": { "get": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：查询租户", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/tenants`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_iam_tenants" }, "post": { "tags": [ "身份与访问控制" ], "summary": "身份与访问控制：创建租户", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/tenants`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "contact_name": { "type": "string" }, "contact_email": { "type": "string" }, "max_users": { "type": "integer" }, "max_plugins": { "type": "integer" }, "config_json": { "type": "string" } }, "additionalProperties": true, "required": [ "name" ], "description": "由源码结构体 `TenantReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "TenantReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_iam_tenants", "x-schema-source": "derived-from-struct" } }, "/api/iam/tenants/{id}": { "put": { "tags": [ "身份与访问控制" ], "summary": "租户：按 id 更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/tenants/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "contact_name": { "type": "string" }, "contact_email": { "type": "string" }, "max_users": { "type": "integer" }, "max_plugins": { "type": "integer" }, "config_json": { "type": "string" } }, "additionalProperties": true, "required": [ "name" ], "description": "由源码结构体 `TenantReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "TenantReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "put_api_iam_tenants_id", "x-schema-source": "derived-from-struct" } }, "/api/iam/tenants/{id}/status/{status}": { "post": { "tags": [ "身份与访问控制" ], "summary": "状态：按 status 操作", "description": "由源码路由表自动生成。真实挂载路径：`/api/iam/tenants/{id}/status/{status}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" }, { "name": "status", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：status" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_iam_tenants_id_status_status" } }, "/api/job-queue/enqueue": { "post": { "tags": [ "任务队列" ], "summary": "任务队列：创建 enqueue", "description": "由源码路由表自动生成。真实挂载路径：`/api/job-queue/enqueue`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "job_type": { "type": "string" }, "job_name": { "type": "string" }, "dedupe_key": { "type": "string" }, "payload": { "description": "任意 JSON" }, "target_url": { "type": "string" }, "priority": { "type": "integer" }, "max_attempts": { "type": "integer" }, "run_at": { "type": "string" } }, "additionalProperties": true, "description": "由源码结构体 `EnqueueReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "EnqueueReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_job_queue_enqueue", "x-schema-source": "derived-from-struct" } }, "/api/job-queue/jobs": { "get": { "tags": [ "任务队列" ], "summary": "任务队列：查询任务", "description": "由源码路由表自动生成。真实挂载路径：`/api/job-queue/jobs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_job_queue_jobs" } }, "/api/job-queue/jobs/{id}": { "delete": { "tags": [ "任务队列" ], "summary": "任务：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/job-queue/jobs/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_job_queue_jobs_id" }, "get": { "tags": [ "任务队列" ], "summary": "任务：按 id 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/job-queue/jobs/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_job_queue_jobs_id" } }, "/api/job-queue/jobs/{id}/retry": { "post": { "tags": [ "任务队列" ], "summary": "任务队列：执行重试（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/job-queue/jobs/{id}/retry`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_job_queue_jobs_id_retry" } }, "/api/job-queue/stats": { "get": { "tags": [ "任务队列" ], "summary": "任务队列：查询统计", "description": "由源码路由表自动生成。真实挂载路径：`/api/job-queue/stats`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_job_queue_stats" } }, "/api/manifest/permissions": { "get": { "tags": [ "插件清单" ], "summary": "插件清单：查询权限", "description": "由源码路由表自动生成。真实挂载路径：`/api/manifest/permissions`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_manifest_permissions" } }, "/api/manifest/scan": { "post": { "tags": [ "插件清单" ], "summary": "插件清单：执行扫描", "description": "由源码路由表自动生成。真实挂载路径：`/api/manifest/scan`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_manifest_scan" } }, "/api/manifest/{code}": { "get": { "tags": [ "插件清单" ], "summary": "插件清单：按 code 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/manifest/{code}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_manifest_code" } }, "/api/market/captcha": { "get": { "tags": [ "插件市场" ], "summary": "插件市场：查询图形验证码", "description": "由源码路由表自动生成。真实挂载路径：`/api/market/captcha`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "x-required-permission": "public", "operationId": "get_api_market_captcha" } }, "/api/market/catalog": { "get": { "tags": [ "插件市场" ], "summary": "插件市场：查询目录", "description": "由源码路由表自动生成。真实挂载路径：`/api/market/catalog`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "x-required-permission": "authenticated", "operationId": "get_api_market_catalog" } }, "/api/market/categories": { "get": { "tags": [ "插件市场" ], "summary": "插件市场：查询分类", "description": "由源码路由表自动生成。真实挂载路径：`/api/market/categories`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "x-required-permission": "authenticated", "operationId": "get_api_market_categories" } }, "/api/market/plugins/{code}/unpublish": { "post": { "tags": [ "插件市场" ], "summary": "插件市场：创建 unpublish（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/market/plugins/{code}/unpublish`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "x-required-permission": "plugin.govern", "operationId": "post_api_market_plugins_code_unpublish" } }, "/api/market/ratings": { "post": { "tags": [ "插件市场" ], "summary": "插件市场：创建评分", "description": "为已上架插件评分（1–5）。需要有效登录身份。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketRatingReq" } } } }, "parameters": [], "x-required-permission": "authenticated", "operationId": "post_api_market_ratings" } }, "/api/market/ratings/{plugin_code}": { "get": { "tags": [ "插件市场" ], "summary": "评分：按 plugin_code 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/market/ratings/{plugin_code}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "plugin_code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：plugin_code" } ], "x-required-permission": "authenticated", "operationId": "get_api_market_ratings_plugin_code" } }, "/api/market/submissions": { "get": { "tags": [ "插件市场" ], "summary": "插件市场：查询提交记录", "description": "由源码路由表自动生成。真实挂载路径：`/api/market/submissions`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "x-required-permission": "authenticated", "operationId": "get_api_market_submissions" } }, "/api/market/submissions/{id}/approve": { "post": { "tags": [ "插件市场" ], "summary": "插件市场：执行批准（按 id 定位）", "description": "批准市场提交。需要 plugin.govern；危险扫描项默认阻断，只有 query force=1 才强制通过。批准不安装、不启用、不部署。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "force", "in": "query", "required": false, "schema": { "type": "boolean" }, "description": "危险扫描项强制批准，仅限治理人员复核后使用" } ], "x-required-permission": "plugin.govern", "operationId": "post_api_market_submissions_id_approve" } }, "/api/market/submissions/{id}/reject": { "post": { "tags": [ "插件市场" ], "summary": "插件市场：执行驳回（按 id 定位）", "description": "驳回市场提交，可写 notes。需要 plugin.govern。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketReviewReq" } } } }, "x-required-permission": "plugin.govern", "operationId": "post_api_market_submissions_id_reject" } }, "/api/market/submit": { "post": { "tags": [ "插件市场" ], "summary": "插件市场：执行提交", "description": "提交市场审核。任意有效登录用户可用，不要求 plugin.manage；版本必须 x.y.z 且高于该插件历史最高上架版本；每用户每分钟最多 3 次。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "plugin_code", "name", "download_url", "captcha_token", "captcha_answer" ], "properties": { "plugin_code": { "type": "string", "pattern": "^[a-z0-9_]{1,64}$" }, "name": { "type": "string" }, "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$", "default": "1.0.0" }, "description": { "type": "string" }, "author": { "type": "string" }, "email": { "type": "string" }, "download_url": { "type": "string", "maxLength": 1024 }, "documentation_url": { "type": "string" }, "category": { "type": "string" }, "tags": { "type": "string", "description": "逗号分隔" }, "captcha_token": { "type": "string" }, "captcha_answer": { "type": "string" } } }, "example": { "plugin_code": "demo_plugin", "name": "示例插件", "version": "1.0.0", "description": "一句话说明插件做什么", "download_url": "/api/market/uploads/demo_plugin.zip", "category": "工具", "tags": "示例,工具", "captcha_token": "", "captcha_answer": "41" } } } }, "parameters": [], "x-required-permission": "authenticated", "operationId": "post_api_market_submit" } }, "/api/market/uploads/{filename}": { "get": { "tags": [ "插件市场" ], "summary": "uploads：按 filename 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/market/uploads/{filename}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "filename", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：filename" } ], "x-required-permission": "public", "operationId": "get_api_market_uploads_filename" } }, "/api/market/versions/{id}/set-current": { "post": { "tags": [ "插件市场" ], "summary": "插件市场：创建 set current（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/market/versions/{id}/set-current`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "x-required-permission": "plugin.govern", "operationId": "post_api_market_versions_id_set_current" } }, "/api/market/versions/{plugin_code}": { "get": { "tags": [ "插件市场" ], "summary": "versions：按 plugin_code 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/market/versions/{plugin_code}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "plugin_code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：plugin_code" } ], "x-required-permission": "authenticated", "operationId": "get_api_market_versions_plugin_code" } }, "/api/metering/generate-invoices": { "post": { "tags": [ "用量计量" ], "summary": "用量计量：创建 generate invoices", "description": "由源码路由表自动生成。真实挂载路径：`/api/metering/generate-invoices`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "period_month": { "type": "string" } }, "additionalProperties": true, "description": "由源码结构体 `GenInvReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "GenInvReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_metering_generate_invoices", "x-schema-source": "derived-from-struct" } }, "/api/metering/usage": { "get": { "tags": [ "用量计量" ], "summary": "用量计量：查询用量", "description": "由源码路由表自动生成。真实挂载路径：`/api/metering/usage`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_metering_usage" }, "post": { "tags": [ "用量计量" ], "summary": "用量计量：创建用量", "description": "由源码路由表自动生成。真实挂载路径：`/api/metering/usage`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "metric": { "type": "string" }, "quantity": { "type": "number" }, "unit_price_cents": { "type": "integer" }, "period_month": { "type": "string" }, "idempotency_key": { "type": "string" } }, "additionalProperties": true, "required": [ "plugin_code", "metric", "quantity", "unit_price_cents" ], "description": "由源码结构体 `UsageReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "UsageReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_metering_usage", "x-schema-source": "derived-from-struct" } }, "/api/notary/keys": { "get": { "tags": [ "签名公证" ], "summary": "签名公证：查询密钥", "description": "由源码路由表自动生成。真实挂载路径：`/api/notary/keys`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_notary_keys" }, "post": { "tags": [ "签名公证" ], "summary": "签名公证：创建密钥", "description": "由源码路由表自动生成。真实挂载路径：`/api/notary/keys`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "label": { "type": "string" }, "scopes": { "type": "string" }, "expires_hours": { "type": "integer" }, "tier": { "type": "string" } }, "additionalProperties": true, "description": "由源码结构体 `CreateKeyReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "CreateKeyReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_notary_keys", "x-schema-source": "derived-from-struct" } }, "/api/notary/keys/{id}": { "delete": { "tags": [ "签名公证" ], "summary": "密钥：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/notary/keys/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_notary_keys_id" } }, "/api/notary/keys/{id}/activate": { "post": { "tags": [ "签名公证" ], "summary": "签名公证：创建 activate（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/notary/keys/{id}/activate`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_notary_keys_id_activate" } }, "/api/notary/verify": { "post": { "tags": [ "签名公证" ], "summary": "签名公证：执行校验", "description": "由源码路由表自动生成。真实挂载路径：`/api/notary/verify`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "artifact_hash": { "type": "string" }, "signature": { "type": "string" }, "public_key": { "type": "string" } }, "additionalProperties": true, "required": [ "artifact_hash", "signature" ], "description": "由源码结构体 `VerifyReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "VerifyReq", "x-struct-definitions": 2 } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_notary_verify", "x-schema-source": "derived-from-struct" } }, "/api/oauth/.well-known/openid-configuration": { "get": { "tags": [ "开放授权" ], "summary": "开放授权：查询 openid configuration", "description": "由源码路由表自动生成。真实挂载路径：`/api/oauth/.well-known/openid-configuration`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_oauth_well_known_openid_configuration" } }, "/api/oauth/authorize": { "get": { "tags": [ "开放授权" ], "summary": "开放授权：查询 authorize", "description": "由源码路由表自动生成。真实挂载路径：`/api/oauth/authorize`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_oauth_authorize" } }, "/api/oauth/clients": { "get": { "tags": [ "开放授权" ], "summary": "开放授权：查询客户端", "description": "由源码路由表自动生成。真实挂载路径：`/api/oauth/clients`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_oauth_clients" }, "post": { "tags": [ "开放授权" ], "summary": "开放授权：创建客户端", "description": "由源码路由表自动生成。真实挂载路径：`/api/oauth/clients`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "client_id": { "type": "string" }, "client_name": { "type": "string" }, "redirect_uris": { "type": "array", "items": { "type": "string" } }, "grant_types": { "type": "array", "items": { "type": "string" } }, "is_confidential": { "type": "boolean" }, "logo_url": { "type": "string" }, "homepage_url": { "type": "string" }, "description": { "type": "string" } }, "additionalProperties": true, "required": [ "client_name", "redirect_uris" ], "description": "由源码结构体 `ClientReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "ClientReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_oauth_clients", "x-schema-source": "derived-from-struct" } }, "/api/oauth/clients/{id}": { "delete": { "tags": [ "开放授权" ], "summary": "客户端：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/oauth/clients/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_oauth_clients_id" } }, "/api/oauth/introspect": { "post": { "tags": [ "开放授权" ], "summary": "开放授权：创建 introspect", "description": "由源码路由表自动生成。真实挂载路径：`/api/oauth/introspect`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_oauth_introspect" } }, "/api/oauth/jwks.json": { "get": { "tags": [ "开放授权" ], "summary": "开放授权：查询 jwks.json", "description": "由源码路由表自动生成。真实挂载路径：`/api/oauth/jwks.json`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_oauth_jwks_json" } }, "/api/oauth/revoke": { "post": { "tags": [ "开放授权" ], "summary": "开放授权：执行撤销", "description": "由源码路由表自动生成。真实挂载路径：`/api/oauth/revoke`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_oauth_revoke" } }, "/api/oauth/token": { "post": { "tags": [ "开放授权" ], "summary": "开放授权：创建令牌", "description": "由源码路由表自动生成。真实挂载路径：`/api/oauth/token`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_oauth_token" } }, "/api/oauth/userinfo": { "get": { "tags": [ "开放授权" ], "summary": "开放授权：查询 userinfo", "description": "由源码路由表自动生成。真实挂载路径：`/api/oauth/userinfo`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_oauth_userinfo" } }, "/api/observability/audit-events": { "get": { "tags": [ "可观测性" ], "summary": "可观测性：查询 audit events", "description": "由源码路由表自动生成。真实挂载路径：`/api/observability/audit-events`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_observability_audit_events" } }, "/api/observability/audit-events/clear": { "post": { "tags": [ "可观测性" ], "summary": "可观测性：执行清空", "description": "由源码路由表自动生成。真实挂载路径：`/api/observability/audit-events/clear`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_observability_audit_events_clear" } }, "/api/observability/circuit-breakers": { "get": { "tags": [ "可观测性" ], "summary": "可观测性：查询 circuit breakers", "description": "由源码路由表自动生成。真实挂载路径：`/api/observability/circuit-breakers`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_observability_circuit_breakers" } }, "/api/observability/circuit-breakers/{code}/reset": { "post": { "tags": [ "可观测性" ], "summary": "可观测性：执行重置（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/observability/circuit-breakers/{code}/reset`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_observability_circuit_breakers_code_reset" } }, "/api/openai/v1/chat/completions": { "post": { "tags": [ "OpenAI 兼容接口" ], "summary": "OpenAI 兼容接口：创建补全", "description": "OpenAI 兼容的对话补全入口，按用户限流与计量；插件内调用优先使用 /api/plugins/{code}/ai/chat。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenAIChatReq" } } } }, "parameters": [], "operationId": "post_api_openai_v1_chat_completions" } }, "/api/openai/v1/models": { "get": { "tags": [ "OpenAI 兼容接口" ], "summary": "OpenAI 兼容接口：查询模型列表", "description": "由源码路由表自动生成。真实挂载路径：`/api/openai/v1/models`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_openai_v1_models" } }, "/api/openrouter/v1/chat/completions": { "post": { "tags": [ "OpenRouter 兼容接口" ], "summary": "OpenRouter 兼容接口：创建补全", "description": "由源码路由表自动生成。真实挂载路径：`/api/openrouter/v1/chat/completions`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_openrouter_v1_chat_completions" } }, "/api/openrouter/v1/models": { "get": { "tags": [ "OpenRouter 兼容接口" ], "summary": "OpenRouter 兼容接口：查询模型列表", "description": "由源码路由表自动生成。真实挂载路径：`/api/openrouter/v1/models`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_openrouter_v1_models" } }, "/api/ops/logs": { "get": { "tags": [ "运维操作" ], "summary": "运维操作：查询日志", "description": "由源码路由表自动生成。真实挂载路径：`/api/ops/logs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_ops_logs" } }, "/api/ops/processes": { "get": { "tags": [ "运维操作" ], "summary": "运维操作：查询 processes", "description": "由源码路由表自动生成。真实挂载路径：`/api/ops/processes`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_ops_processes" } }, "/api/ownapp/generate": { "post": { "tags": [ "自有应用打包" ], "summary": "自有应用打包：创建 generate", "description": "由源码路由表自动生成。真实挂载路径：`/api/ownapp/generate`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "project": { "type": "string" }, "app_name": { "type": "string" }, "platforms": { "type": "object", "properties": { "mp": { "type": "boolean" }, "app": { "type": "boolean" }, "exe": { "type": "boolean" } }, "additionalProperties": true } }, "additionalProperties": true, "required": [ "project" ], "description": "由源码结构体 `GenerateReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "GenerateReq", "x-struct-definitions": 2 } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_ownapp_generate", "x-schema-source": "derived-from-struct" } }, "/api/ownapp/jobs": { "get": { "tags": [ "自有应用打包" ], "summary": "自有应用打包：查询任务", "description": "由源码路由表自动生成。真实挂载路径：`/api/ownapp/jobs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_ownapp_jobs" } }, "/api/ownapp/jobs/{id}": { "delete": { "tags": [ "自有应用打包" ], "summary": "任务：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/ownapp/jobs/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_ownapp_jobs_id" }, "get": { "tags": [ "自有应用打包" ], "summary": "任务：按 id 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/ownapp/jobs/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_ownapp_jobs_id" } }, "/api/ownapp/jobs/{id}/artifact/{platform}": { "get": { "tags": [ "自有应用打包" ], "summary": "artifact：按 platform 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/ownapp/jobs/{id}/artifact/{platform}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" }, { "name": "platform", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：platform" } ], "operationId": "get_api_ownapp_jobs_id_artifact_platform" } }, "/api/ownapp/jobs/{id}/build": { "post": { "tags": [ "自有应用打包" ], "summary": "自有应用打包：执行构建（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/ownapp/jobs/{id}/build`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "target_id": { "type": "integer" }, "plugin_code": { "type": "string" } }, "additionalProperties": true, "required": [ "target_id" ], "description": "由源码结构体 `TriggerReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "TriggerReq", "x-struct-definitions": 2 } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_ownapp_jobs_id_build", "x-schema-source": "derived-from-struct" } }, "/api/payment_intents": { "post": { "tags": [ "支付意图" ], "summary": "支付意图：创建", "description": "由源码路由表自动生成。真实挂载路径：`/api/payment_intents`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "amount": { "type": "integer" }, "currency": { "type": "string" }, "description": { "type": "string" }, "metadata": { "description": "任意 JSON" }, "payment_method": { "type": "string" }, "confirm": { "type": "boolean" } }, "additionalProperties": true, "required": [ "amount" ], "description": "由源码结构体 `CreatePIReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "CreatePIReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_payment_intents", "x-schema-source": "derived-from-struct" } }, "/api/payment_intents/{id}": { "get": { "tags": [ "支付意图" ], "summary": "支付意图：按 id 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/payment_intents/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_payment_intents_id" } }, "/api/plugin-data/docs": { "get": { "tags": [ "插件数据存储" ], "summary": "插件数据存储：查询文档", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-data/docs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugin_data_docs" } }, "/api/plugin-data/docs/{id}": { "delete": { "tags": [ "插件数据存储" ], "summary": "文档：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-data/docs/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_plugin_data_docs_id" } }, "/api/plugin-data/kv": { "get": { "tags": [ "插件数据存储" ], "summary": "插件数据存储：查询键值", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-data/kv`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugin_data_kv" } }, "/api/plugin-data/kv/delete": { "post": { "tags": [ "插件数据存储" ], "summary": "插件数据存储：创建 delete", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-data/kv/delete`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin": { "type": "string" }, "key": { "type": "string" }, "tenant_id": { "type": "integer" }, "caller_sub": { "type": "string" } }, "additionalProperties": true, "required": [ "plugin", "key" ], "description": "由源码结构体 `AdminKvDelReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "AdminKvDelReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_plugin_data_kv_delete", "x-schema-source": "derived-from-struct" } }, "/api/plugin-data/overview": { "get": { "tags": [ "插件数据存储" ], "summary": "插件数据存储：查询概览", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-data/overview`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugin_data_overview" } }, "/api/plugin-events/hooks": { "get": { "tags": [ "插件事件内核" ], "summary": "插件事件内核：查询钩子", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/hooks`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugin_events_hooks" }, "post": { "tags": [ "插件事件内核" ], "summary": "插件事件内核：创建钩子", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/hooks`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "hook_point": { "type": "string" }, "priority": { "type": "integer" }, "enabled": { "type": "boolean" }, "target_url": { "type": "string" }, "timeout_ms": { "type": "integer" } }, "additionalProperties": true, "required": [ "plugin_code", "hook_point" ], "description": "由源码结构体 `RegisterReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "RegisterReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_plugin_events_hooks", "x-schema-source": "derived-from-struct" } }, "/api/plugin-events/hooks/{id}": { "put": { "tags": [ "插件事件内核" ], "summary": "钩子：按 id 更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/hooks/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "priority": { "type": "integer" }, "enabled": { "type": "boolean" }, "target_url": { "type": "string" }, "timeout_ms": { "type": "integer" } }, "additionalProperties": true, "description": "由源码结构体 `UpdateReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "UpdateReq", "x-struct-definitions": 4 } } } }, "x-contract-status": "internal-admin-generic", "operationId": "put_api_plugin_events_hooks_id", "x-schema-source": "derived-from-struct" } }, "/api/plugin-events/hooks/{id}/deliveries": { "get": { "tags": [ "插件事件内核" ], "summary": "插件事件内核：查询投递记录（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/hooks/{id}/deliveries`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_plugin_events_hooks_id_deliveries" } }, "/api/plugin-events/hooks/{id}/test": { "post": { "tags": [ "插件事件内核" ], "summary": "插件事件内核：执行测试（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/hooks/{id}/test`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "sample": { "description": "任意 JSON" } }, "additionalProperties": true, "description": "由源码结构体 `TestReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "TestReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_plugin_events_hooks_id_test", "x-schema-source": "derived-from-struct" } }, "/api/plugin-events/rpc-grants": { "get": { "tags": [ "插件事件内核" ], "summary": "插件事件内核：查询 rpc grants", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/rpc-grants`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugin_events_rpc_grants" }, "post": { "tags": [ "插件事件内核" ], "summary": "插件事件内核：创建 rpc grants", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/rpc-grants`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "caller_code": { "type": "string" }, "target_code": { "type": "string" }, "method": { "type": "string" } }, "additionalProperties": true, "required": [ "caller_code", "target_code", "method" ], "description": "由源码结构体 `RpcGrantReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "RpcGrantReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_plugin_events_rpc_grants", "x-schema-source": "derived-from-struct" } }, "/api/plugin-events/rpc-grants/{id}": { "delete": { "tags": [ "插件事件内核" ], "summary": "rpc grants：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/rpc-grants/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_plugin_events_rpc_grants_id" } }, "/api/plugin-events/ui-slots": { "get": { "tags": [ "插件事件内核" ], "summary": "插件事件内核：查询界面插槽", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/ui-slots`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugin_events_ui_slots" }, "post": { "tags": [ "插件事件内核" ], "summary": "插件事件内核：创建界面插槽", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/ui-slots`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "slot_name": { "type": "string" }, "plugin_code": { "type": "string" }, "title": { "type": "string" }, "config_json": { "description": "任意 JSON" }, "sort_order": { "type": "integer" }, "enabled": { "type": "integer" } }, "additionalProperties": true, "required": [ "slot_name" ], "description": "由源码结构体 `UiSlotReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "UiSlotReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_plugin_events_ui_slots", "x-schema-source": "derived-from-struct" } }, "/api/plugin-events/ui-slots/{x}": { "delete": { "tags": [ "插件事件内核" ], "summary": "界面插槽：按 x 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/ui-slots/{x}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "x", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：x" } ], "operationId": "delete_api_plugin_events_ui_slots_x" }, "get": { "tags": [ "插件事件内核" ], "summary": "界面插槽：按 x 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/ui-slots/{x}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "x", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：x" } ], "operationId": "get_api_plugin_events_ui_slots_x" }, "put": { "tags": [ "插件事件内核" ], "summary": "界面插槽：按 x 更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-events/ui-slots/{x}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "x", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：x" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "slot_name": { "type": "string" }, "plugin_code": { "type": "string" }, "title": { "type": "string" }, "config_json": { "description": "任意 JSON" }, "sort_order": { "type": "integer" }, "enabled": { "type": "integer" } }, "additionalProperties": true, "required": [ "slot_name" ], "description": "由源码结构体 `UiSlotReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "UiSlotReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "put_api_plugin_events_ui_slots_x", "x-schema-source": "derived-from-struct" } }, "/api/plugin-sandbox/configs": { "get": { "tags": [ "插件沙箱" ], "summary": "插件沙箱：查询配置", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-sandbox/configs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugin_sandbox_configs" }, "post": { "tags": [ "插件沙箱" ], "summary": "插件沙箱：创建配置", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-sandbox/configs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "runtime": { "type": "string" }, "entry_file": { "type": "string" }, "config": { "type": "object", "properties": { "env": { "type": "array", "items": {} }, "args": { "type": "array", "items": { "type": "string" } }, "network_policy": { "type": "string" }, "filesystem_policy": { "type": "string" }, "memory_mb": { "type": "integer" }, "cpu_ms": { "type": "integer" }, "timeout_ms": { "type": "integer" }, "wasm_runtime": { "type": "string" } }, "additionalProperties": true } }, "additionalProperties": true, "required": [ "plugin_code", "runtime" ], "description": "由源码结构体 `SandboxConfigReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "SandboxConfigReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_plugin_sandbox_configs", "x-schema-source": "derived-from-struct" } }, "/api/plugin-sandbox/configs/{code}": { "get": { "tags": [ "插件沙箱" ], "summary": "配置：按 code 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-sandbox/configs/{code}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugin_sandbox_configs_code" } }, "/api/plugin-sandbox/configs/{code}/exec": { "post": { "tags": [ "插件沙箱" ], "summary": "插件沙箱：执行执行（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-sandbox/configs/{code}/exec`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "payload": { "description": "任意 JSON" } }, "additionalProperties": true, "description": "由源码结构体 `ExecReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "ExecReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_plugin_sandbox_configs_code_exec", "x-schema-source": "derived-from-struct" } }, "/api/plugin-sandbox/configs/{code}/lifecycle": { "post": { "tags": [ "插件沙箱" ], "summary": "插件沙箱：创建 lifecycle（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-sandbox/configs/{code}/lifecycle`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "state": { "type": "string" } }, "additionalProperties": true, "required": [ "state" ], "description": "由源码结构体 `LifecycleReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "LifecycleReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_plugin_sandbox_configs_code_lifecycle", "x-schema-source": "derived-from-struct" } }, "/api/plugin-sandbox/overview": { "get": { "tags": [ "插件沙箱" ], "summary": "插件沙箱：查询概览", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-sandbox/overview`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugin_sandbox_overview" } }, "/api/plugin-sandbox/run-example": { "post": { "tags": [ "插件沙箱" ], "summary": "插件沙箱：创建 run example", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-sandbox/run-example`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_plugin_sandbox_run_example" } }, "/api/plugin-sandbox/runs": { "get": { "tags": [ "插件沙箱" ], "summary": "插件沙箱：查询运行记录", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-sandbox/runs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugin_sandbox_runs" } }, "/api/plugin-sandbox/runs/{id}": { "delete": { "tags": [ "插件沙箱" ], "summary": "运行记录：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-sandbox/runs/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_plugin_sandbox_runs_id" } }, "/api/plugin-storage/buckets": { "get": { "tags": [ "插件对象存储管理" ], "summary": "插件对象存储管理：查询存储桶", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-storage/buckets`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugin_storage_buckets" }, "post": { "tags": [ "插件对象存储管理" ], "summary": "插件对象存储管理：创建存储桶", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-storage/buckets`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "suffix": { "type": "string" } }, "additionalProperties": true, "required": [ "plugin_code" ], "description": "由源码结构体 `CreateBucketReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "CreateBucketReq", "x-struct-definitions": 2 } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_plugin_storage_buckets", "x-schema-source": "derived-from-struct" } }, "/api/plugin-storage/buckets/{bucket}": { "delete": { "tags": [ "插件对象存储管理" ], "summary": "存储桶：按 bucket 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-storage/buckets/{bucket}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "bucket", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：bucket" } ], "operationId": "delete_api_plugin_storage_buckets_bucket" } }, "/api/plugin-storage/buckets/{bucket}/objects": { "get": { "tags": [ "插件对象存储管理" ], "summary": "插件对象存储管理：查询对象（按 bucket 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-storage/buckets/{bucket}/objects`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "bucket", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：bucket" } ], "operationId": "get_api_plugin_storage_buckets_bucket_objects" } }, "/api/plugin-storage/buckets/{bucket}/policy": { "get": { "tags": [ "插件对象存储管理" ], "summary": "插件对象存储管理：查询策略（按 bucket 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-storage/buckets/{bucket}/policy`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "bucket", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：bucket" } ], "operationId": "get_api_plugin_storage_buckets_bucket_policy" }, "put": { "tags": [ "插件对象存储管理" ], "summary": "插件对象存储管理：更新策略（按 bucket 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-storage/buckets/{bucket}/policy`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "bucket", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：bucket" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "max_total_mb": { "type": "integer" }, "max_object_mb": { "type": "integer" } }, "additionalProperties": true, "required": [ "max_total_mb", "max_object_mb" ], "description": "由源码结构体 `PolicyReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "PolicyReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "put_api_plugin_storage_buckets_bucket_policy", "x-schema-source": "derived-from-struct" } }, "/api/plugins/cdn_font/groups": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询分组", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_font/groups`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugins_cdn_font_groups" }, "post": { "tags": [ "插件管理" ], "summary": "插件管理：创建分组", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_font/groups`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "native-cdn-admin-generic", "operationId": "post_api_plugins_cdn_font_groups" } }, "/api/plugins/cdn_font/groups/{id}": { "delete": { "tags": [ "插件" ], "summary": "分组：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_font/groups/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_plugins_cdn_font_groups_id" }, "put": { "tags": [ "插件管理" ], "summary": "分组：按 id 更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_font/groups/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "native-cdn-admin-generic", "operationId": "put_api_plugins_cdn_font_groups_id" } }, "/api/plugins/cdn_font/items": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询条目", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_font/items`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugins_cdn_font_items" }, "post": { "tags": [ "插件管理" ], "summary": "插件管理：创建条目", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_font/items`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "native-cdn-admin-generic", "operationId": "post_api_plugins_cdn_font_items" } }, "/api/plugins/cdn_font/items/{id}": { "delete": { "tags": [ "插件" ], "summary": "条目：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_font/items/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_plugins_cdn_font_items_id" }, "put": { "tags": [ "插件管理" ], "summary": "条目：按 id 更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_font/items/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "native-cdn-admin-generic", "operationId": "put_api_plugins_cdn_font_items_id" } }, "/api/plugins/cdn_image/file/{tenant}/{name}": { "get": { "tags": [ "插件" ], "summary": "tenant：按 name 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_image/file/{tenant}/{name}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "tenant", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：tenant" }, { "name": "name", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：name" } ], "operationId": "get_api_plugins_cdn_image_file_tenant_name" } }, "/api/plugins/cdn_image/groups": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询分组", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_image/groups`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugins_cdn_image_groups" }, "post": { "tags": [ "插件管理" ], "summary": "插件管理：创建分组", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_image/groups`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "native-cdn-admin-generic", "operationId": "post_api_plugins_cdn_image_groups" } }, "/api/plugins/cdn_image/groups/{id}": { "delete": { "tags": [ "插件" ], "summary": "分组：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_image/groups/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_plugins_cdn_image_groups_id" }, "put": { "tags": [ "插件管理" ], "summary": "分组：按 id 更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_image/groups/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "native-cdn-admin-generic", "operationId": "put_api_plugins_cdn_image_groups_id" } }, "/api/plugins/cdn_image/items": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询条目", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_image/items`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_plugins_cdn_image_items" }, "post": { "tags": [ "插件管理" ], "summary": "插件管理：创建条目", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_image/items`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "native-cdn-admin-generic", "operationId": "post_api_plugins_cdn_image_items" } }, "/api/plugins/cdn_image/items/upload": { "post": { "tags": [ "插件" ], "summary": "插件管理：创建上传", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_image/items/upload`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "native-cdn-admin-generic", "operationId": "post_api_plugins_cdn_image_items_upload" } }, "/api/plugins/cdn_image/items/{id}": { "delete": { "tags": [ "插件" ], "summary": "条目：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_image/items/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_plugins_cdn_image_items_id" } }, "/api/plugins/cdn_image/upload": { "post": { "tags": [ "插件" ], "summary": "插件管理：创建上传", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/cdn_image/upload`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "native-cdn-admin-generic", "operationId": "post_api_plugins_cdn_image_upload" } }, "/api/plugins/{code}/admin-token": { "post": { "tags": [ "插件" ], "summary": "插件管理：创建 admin token（按 code 定位）", "description": "管理员代插件申领 scope 令牌。需要 plugin.govern；请求 scope 必须是已授权给该插件的 scope。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginTokenReq" } } } }, "operationId": "post_api_plugins_code_admin_token" } }, "/api/plugins/{code}/ai/chat": { "post": { "tags": [ "插件" ], "summary": "插件管理：创建对话（按 code 定位）", "description": "插件调用平台 AI 网关。需要 plugin.manage，受插件状态、平台配额与上游配置限制。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginAiChatReq" } } } }, "operationId": "post_api_plugins_code_ai_chat" } }, "/api/plugins/{code}/ai/usage": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询用量（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/ai/usage`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_ai_usage" } }, "/api/plugins/{code}/config": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询配置（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/config`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_config" }, "put": { "tags": [ "插件管理" ], "summary": "插件管理：更新配置（按 code 定位）", "description": "整体保存插件配置 JSON。需要 plugin.manage。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "description": "配置键值对象，整体写入" } } } }, "operationId": "put_api_plugins_code_config" } }, "/api/plugins/{code}/config/schema": { "put": { "tags": [ "插件" ], "summary": "插件管理：更新结构（按 code 定位）", "description": "整体覆盖插件配置 Schema。需要 plugin.manage。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginConfigSchema" } } } }, "operationId": "put_api_plugins_code_config_schema" } }, "/api/plugins/{code}/data/{collection}": { "get": { "tags": [ "插件" ], "summary": "data：按 collection 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/data/{collection}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "collection", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：collection" } ], "operationId": "get_api_plugins_code_data_collection" }, "post": { "tags": [ "插件管理" ], "summary": "data：按 collection 操作", "description": "创建文档。请求体就是文档 JSON；不是 data 包装。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "collection", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：collection" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "description": "文档对象本身；字段由插件业务与集合 schema 决定" }, "example": { "title": "第一条记录", "payload": { "any": "插件自定义字段" } } } } }, "operationId": "post_api_plugins_code_data_collection" } }, "/api/plugins/{code}/data/{collection}/schema": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询结构（按 code、collection 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/data/{collection}/schema`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "collection", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：collection" } ], "operationId": "get_api_plugins_code_data_collection_schema" }, "put": { "tags": [ "插件管理" ], "summary": "插件管理：更新结构（按 code、collection 定位）", "description": "整体覆盖集合字段校验规则。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "collection", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：collection" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "fields" ], "properties": { "fields": { "type": "array", "items": { "type": "object" } } } } } } }, "operationId": "put_api_plugins_code_data_collection_schema" } }, "/api/plugins/{code}/data/{collection}/{doc_id}": { "delete": { "tags": [ "插件" ], "summary": "collection：按 doc_id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/data/{collection}/{doc_id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "collection", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：collection" }, { "name": "doc_id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：doc_id" } ], "operationId": "delete_api_plugins_code_data_collection_doc_id" }, "get": { "tags": [ "插件管理" ], "summary": "collection：按 doc_id 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/data/{collection}/{doc_id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "collection", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：collection" }, { "name": "doc_id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：doc_id" } ], "operationId": "get_api_plugins_code_data_collection_doc_id" }, "put": { "tags": [ "插件管理" ], "summary": "collection：按 doc_id 更新", "description": "更新文档。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "collection", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：collection" }, { "name": "doc_id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：doc_id" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "description": "完整或部分文档字段，由集合 schema 决定" } } } }, "operationId": "put_api_plugins_code_data_collection_doc_id" } }, "/api/plugins/{code}/files": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询文件（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/files`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_files" } }, "/api/plugins/{code}/files/upload": { "post": { "tags": [ "插件" ], "summary": "插件管理：创建上传（按 code 定位）", "description": "上传插件文件到调用者数据岛。需要 plugin.manage；query 必须带 ?path=相对路径。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "path", "in": "query", "required": true, "schema": { "type": "string" }, "description": "插件数据岛内的相对文件路径" }, { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "file" ], "properties": { "file": { "type": "string", "format": "binary" } } } } } }, "operationId": "post_api_plugins_code_files_upload" } }, "/api/plugins/{code}/grants": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询授权（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/grants`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_grants" }, "post": { "tags": [ "插件管理" ], "summary": "插件管理：创建授权（按 code 定位）", "description": "管理员为插件授权 scope。需要 plugin.govern。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "scopes" ], "properties": { "scopes": { "type": "array", "items": { "type": "string" }, "minItems": 1 }, "expires_at": { "type": "string", "description": "YYYY-MM-DD HH:MM:SS 或 ISO；可选" } } } } } }, "operationId": "post_api_plugins_code_grants" } }, "/api/plugins/{code}/grants/{scope}": { "delete": { "tags": [ "插件" ], "summary": "授权：按 scope 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/grants/{scope}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "scope", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：scope" } ], "operationId": "delete_api_plugins_code_grants_scope" } }, "/api/plugins/{code}/health": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询健康检查（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/health`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_health" } }, "/api/plugins/{code}/health/ping": { "post": { "tags": [ "插件" ], "summary": "插件管理：创建 ping（按 code 定位）", "description": "公开插件心跳上报。插件必须存在；按 IP 限流；status 与 avg_response_ms 会被校验/钳制。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "healthy", "unhealthy", "degraded", "down", "unknown" ], "default": "healthy" }, "avg_response_ms": { "type": "integer", "minimum": 0, "maximum": 600000, "default": 0 } } } } } }, "security": [], "operationId": "post_api_plugins_code_health_ping" } }, "/api/plugins/{code}/hooks": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询钩子（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/hooks`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_hooks" }, "post": { "tags": [ "插件管理" ], "summary": "插件管理：创建钩子（按 code 定位）", "description": "为插件注册事件回调。需要 plugin.manage。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HookRegisterReq" } } } }, "operationId": "post_api_plugins_code_hooks" } }, "/api/plugins/{code}/hooks/{id}": { "delete": { "tags": [ "插件" ], "summary": "钩子：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/hooks/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_plugins_code_hooks_id" } }, "/api/plugins/{code}/jobs": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询任务（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/jobs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_jobs" }, "post": { "tags": [ "插件管理" ], "summary": "插件管理：创建任务（按 code 定位）", "description": "向异步任务队列投递任务。需要 plugin.manage；插件身份由路径 code 决定。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobEnqueueReq" } } } }, "operationId": "post_api_plugins_code_jobs" } }, "/api/plugins/{code}/kv/{key}": { "delete": { "tags": [ "插件" ], "summary": "键值：按 key 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/kv/{key}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：key" } ], "operationId": "delete_api_plugins_code_kv_key" }, "get": { "tags": [ "插件管理" ], "summary": "键值：按 key 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/kv/{key}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：key" } ], "operationId": "get_api_plugins_code_kv_key" }, "put": { "tags": [ "插件管理" ], "summary": "键值：按 key 更新", "description": "写入带 TTL 的键值，值可为任意 JSON；按调用者数据岛隔离。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：key" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginKvPutReq" } } } }, "operationId": "put_api_plugins_code_kv_key" } }, "/api/plugins/{code}/payments": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询 payments（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/payments`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_payments" }, "post": { "tags": [ "插件管理" ], "summary": "插件管理：创建 payments（按 code 定位）", "description": "插件内扣费。金额单位为微单位且必须大于 0；user_id 指向该插件自己的用户。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginPaymentReq" } } } }, "operationId": "post_api_plugins_code_payments" } }, "/api/plugins/{code}/push": { "post": { "tags": [ "插件" ], "summary": "插件管理：执行推送（按 code 定位）", "description": "向插件房间推送实时消息。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginPushReq" } } } }, "operationId": "post_api_plugins_code_push" } }, "/api/plugins/{code}/rooms": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询 rooms（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/rooms`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_rooms" }, "post": { "tags": [ "插件管理" ], "summary": "插件管理：创建 rooms（按 code 定位）", "description": "创建或更新插件房间。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginRoomReq" } } } }, "operationId": "post_api_plugins_code_rooms" } }, "/api/plugins/{code}/rpc": { "post": { "tags": [ "插件" ], "summary": "插件管理：创建 rpc（按 code 定位）", "description": "跨插件 RPC 调用。需要 plugin.manage，且 caller→target/method 必须有 plugin_rpc_grants 显式授权。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RpcCallReq" } } } }, "operationId": "post_api_plugins_code_rpc" } }, "/api/plugins/{code}/sandbox/exec": { "post": { "tags": [ "插件" ], "summary": "插件管理：执行执行（按 code 定位）", "description": "执行已配置且 active 的插件沙箱。需要 plugin.manage；默认 timeout 5000ms、memory 256MB、cpu 1000ms、network deny、filesystem readonly。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "payload": { "description": "传给沙箱入口的任意 JSON" } } } } } }, "operationId": "post_api_plugins_code_sandbox_exec" } }, "/api/plugins/{code}/scheduler": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询 scheduler（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/scheduler`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_scheduler" }, "post": { "tags": [ "插件管理" ], "summary": "插件管理：创建 scheduler（按 code 定位）", "description": "创建定时任务。需要 plugin.manage。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SchedulerCreateReq" } } } }, "operationId": "post_api_plugins_code_scheduler" } }, "/api/plugins/{code}/scheduler/{id}": { "delete": { "tags": [ "插件" ], "summary": "scheduler：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/scheduler/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_plugins_code_scheduler_id" }, "put": { "tags": [ "插件管理" ], "summary": "scheduler：按 id 更新", "description": "更新定时任务。需要 plugin.manage 与归属校验。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SchedulerUpdateReq" } } } }, "operationId": "put_api_plugins_code_scheduler_id" } }, "/api/plugins/{code}/schemas": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询 schemas（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/schemas`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_schemas" } }, "/api/plugins/{code}/storage/objects": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询对象（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/storage/objects`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_storage_objects" } }, "/api/plugins/{code}/store": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询 store（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/store`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_store" } }, "/api/plugins/{code}/token": { "post": { "tags": [ "插件" ], "summary": "插件管理：创建令牌（按 code 定位）", "description": "插件用插件专属验签密钥申领限时 scope 令牌。必须带 X-Platform-Signature（HMAC-SHA256(插件密钥, code+timestamp)）、X-Platform-Timestamp、X-Platform-Plugin、X-Platform-Signature-Version: v1；scope 必须已由 plugin.govern 管理员授权且未过期。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginTokenReq" } } } }, "operationId": "post_api_plugins_code_token" } }, "/api/plugins/{code}/token/verify": { "post": { "tags": [ "插件" ], "summary": "插件管理：执行校验（按 code 定位）", "description": "校验插件作用域令牌，需要 plugin.view。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginTokenVerifyReq" } } } }, "operationId": "post_api_plugins_code_token_verify" } }, "/api/plugins/{code}/ui-slots": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询界面插槽（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/ui-slots`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_ui_slots" }, "post": { "tags": [ "插件管理" ], "summary": "插件管理：创建界面插槽（按 code 定位）", "description": "创建/更新插件自己的 UI 插槽。plugin_code 由路径覆盖。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UiSlotReq" } } } }, "operationId": "post_api_plugins_code_ui_slots" } }, "/api/plugins/{code}/ui-slots/{id}": { "delete": { "tags": [ "插件" ], "summary": "界面插槽：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/ui-slots/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_plugins_code_ui_slots_id" } }, "/api/plugins/{code}/users": { "get": { "tags": [ "插件" ], "summary": "插件管理：查询用户（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/users`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "operationId": "get_api_plugins_code_users" } }, "/api/plugins/{code}/users/login": { "post": { "tags": [ "插件" ], "summary": "插件管理：创建登录（按 code 定位）", "description": "插件自有用户登录，公开端点；按 IP 限流。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginUserLoginReq" } } } }, "operationId": "post_api_plugins_code_users_login" } }, "/api/plugins/{code}/users/register": { "post": { "tags": [ "插件" ], "summary": "插件管理：创建 register（按 code 定位）", "description": "插件自有用户注册，公开端点；插件必须存在且启用，按 IP 限流。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PluginUserRegisterReq" } } } }, "operationId": "post_api_plugins_code_users_register" } }, "/api/products": { "get": { "tags": [ "商品" ], "summary": "商品：查询列表", "description": "由源码路由表自动生成。真实挂载路径：`/api/products`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_products" }, "post": { "tags": [ "商品" ], "summary": "商品：创建", "description": "由源码路由表自动生成。真实挂载路径：`/api/products`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "metadata": { "description": "任意 JSON" } }, "additionalProperties": true, "required": [ "name" ], "description": "由源码结构体 `CreateProductReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "CreateProductReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_products", "x-schema-source": "derived-from-struct" } }, "/api/proxy/file": { "post": { "tags": [ "代理转发" ], "summary": "代理转发：创建文件", "description": "平台鉴权反向代理，仅 remote + base_url 可用。读方法需要 plugin.view，写方法需要 plugin.manage。平台注入 X-Platform-Signature / X-Platform-Caller-Signature（按插件派生密钥，推荐校验）、旧 X-Platform-Token（平台全局密钥，仅为兼容，外部插件不应依赖）以及租户/调用者头；同时剥离调用者 Authorization/Cookie/x-api-key/x-auth-token。响应上限 16 MB，默认超时 15 秒。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "filename": { "type": "string" } }, "additionalProperties": true, "required": [ "url" ], "description": "由源码结构体 `ProxyFileReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "ProxyFileReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_proxy_file", "x-schema-source": "derived-from-struct" } }, "/api/proxy/http": { "post": { "tags": [ "代理转发" ], "summary": "代理转发：创建 http", "description": "平台鉴权反向代理，仅 remote + base_url 可用。读方法需要 plugin.view，写方法需要 plugin.manage。平台注入 X-Platform-Signature / X-Platform-Caller-Signature（按插件派生密钥，推荐校验）、旧 X-Platform-Token（平台全局密钥，仅为兼容，外部插件不应依赖）以及租户/调用者头；同时剥离调用者 Authorization/Cookie/x-api-key/x-auth-token。响应上限 16 MB，默认超时 15 秒。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "method": { "type": "string" }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "body": { "type": "string" }, "category": { "type": "string" } }, "additionalProperties": true, "required": [ "url" ], "description": "由源码结构体 `ProxyHttpReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "ProxyHttpReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_proxy_http", "x-schema-source": "derived-from-struct" } }, "/api/proxy/logs": { "get": { "tags": [ "代理转发" ], "summary": "代理转发：查询日志", "description": "平台鉴权反向代理，仅 remote + base_url 可用。读方法需要 plugin.view，写方法需要 plugin.manage。平台注入 X-Platform-Signature / X-Platform-Caller-Signature（按插件派生密钥，推荐校验）、旧 X-Platform-Token（平台全局密钥，仅为兼容，外部插件不应依赖）以及租户/调用者头；同时剥离调用者 Authorization/Cookie/x-api-key/x-auth-token。响应上限 16 MB，默认超时 15 秒。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_proxy_logs" } }, "/api/proxy/logs/clear": { "post": { "tags": [ "代理转发" ], "summary": "代理转发：执行清空", "description": "平台鉴权反向代理，仅 remote + base_url 可用。读方法需要 plugin.view，写方法需要 plugin.manage。平台注入 X-Platform-Signature / X-Platform-Caller-Signature（按插件派生密钥，推荐校验）、旧 X-Platform-Token（平台全局密钥，仅为兼容，外部插件不应依赖）以及租户/调用者头；同时剥离调用者 Authorization/Cookie/x-api-key/x-auth-token。响应上限 16 MB，默认超时 15 秒。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_proxy_logs_clear" } }, "/api/public/plugins/{code}/ai-report": { "post": { "tags": [ "公开接口" ], "summary": "公开接口：创建 ai report（按 code 定位）", "description": "匿名提交插件 AI 报告，业务字段平铺；高频时提示验证码。数据落入 public 数据岛。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicAiReportReq" } } } }, "security": [], "operationId": "post_api_public_plugins_code_ai_report" } }, "/api/public/plugins/{code}/data/{collection}": { "post": { "tags": [ "公开接口" ], "summary": "data：按 collection 操作", "description": "匿名向插件公共收件箱写入文档。业务字段平铺 + 一次性验证码；高频提交需要验证码，数据落入 public 数据岛。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "collection", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：collection" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicPluginDocReq" } } } }, "security": [], "operationId": "post_api_public_plugins_code_data_collection" } }, "/api/riskctl/evaluate": { "post": { "tags": [ "风险控制" ], "summary": "风险控制：执行评估", "description": "由源码路由表自动生成。真实挂载路径：`/api/riskctl/evaluate`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "signals": { "description": "任意 JSON" } }, "additionalProperties": true, "required": [ "plugin_code", "signals" ], "description": "由源码结构体 `EvalReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "EvalReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_riskctl_evaluate", "x-schema-source": "derived-from-struct" } }, "/api/riskctl/events": { "get": { "tags": [ "风险控制" ], "summary": "风险控制：查询事件", "description": "由源码路由表自动生成。真实挂载路径：`/api/riskctl/events`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_riskctl_events" } }, "/api/riskctl/overview": { "get": { "tags": [ "风险控制" ], "summary": "风险控制：查询概览", "description": "由源码路由表自动生成。真实挂载路径：`/api/riskctl/overview`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_riskctl_overview" } }, "/api/riskctl/{code}/override": { "post": { "tags": [ "风险控制" ], "summary": "风险控制：创建 override（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/riskctl/{code}/override`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_riskctl_code_override" } }, "/api/saml/acs": { "post": { "tags": [ "单点登录（SAML）" ], "summary": "单点登录（SAML）：创建 acs", "description": "由源码路由表自动生成。真实挂载路径：`/api/saml/acs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_saml_acs" } }, "/api/saml/metadata": { "get": { "tags": [ "单点登录（SAML）" ], "summary": "单点登录（SAML）：查询 metadata", "description": "由源码路由表自动生成。真实挂载路径：`/api/saml/metadata`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_saml_metadata" } }, "/api/saml/sp": { "get": { "tags": [ "单点登录（SAML）" ], "summary": "单点登录（SAML）：查询 sp", "description": "由源码路由表自动生成。真实挂载路径：`/api/saml/sp`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_saml_sp" } }, "/api/secscan/results": { "get": { "tags": [ "安全扫描" ], "summary": "安全扫描：查询 results", "description": "由源码路由表自动生成。真实挂载路径：`/api/secscan/results`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_secscan_results" } }, "/api/secscan/run": { "post": { "tags": [ "安全扫描" ], "summary": "安全扫描：执行运行", "description": "由源码路由表自动生成。真实挂载路径：`/api/secscan/run`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" } }, "additionalProperties": true, "required": [ "plugin_code" ], "description": "由源码结构体 `ScanReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "ScanReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_secscan_run", "x-schema-source": "derived-from-struct" } }, "/api/settings": { "get": { "tags": [ "系统设置" ], "summary": "系统设置：查询列表", "description": "由源码路由表自动生成。真实挂载路径：`/api/settings`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_settings" }, "put": { "tags": [ "系统设置" ], "summary": "系统设置：更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/settings`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string" }, "menu_json": { "type": "string" }, "logo_type": { "type": "string" }, "logo_text_config": { "description": "任意 JSON" }, "logo_image_config": { "description": "任意 JSON" }, "logo": { "description": "任意 JSON" }, "logo_json": { "type": "string" }, "site_json": { "description": "任意 JSON" } }, "additionalProperties": true, "description": "由源码结构体 `UpdateReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "UpdateReq", "x-struct-definitions": 4 } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "put_api_settings", "x-schema-source": "derived-from-struct" } }, "/api/settlements/": { "get": { "tags": [ "分账结算" ], "summary": "分账结算：查询列表", "description": "由源码路由表自动生成。真实挂载路径：`/api/settlements/`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_settlements" }, "post": { "tags": [ "分账结算" ], "summary": "分账结算：创建", "description": "由源码路由表自动生成。真实挂载路径：`/api/settlements/`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "developer": { "type": "string" }, "period_month": { "type": "string" }, "gross_cents": { "type": "integer" }, "fee_pct": { "type": "number" } }, "additionalProperties": true, "required": [ "plugin_code", "period_month", "gross_cents" ], "description": "由源码结构体 `SettleReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "SettleReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_settlements", "x-schema-source": "derived-from-struct" } }, "/api/settlements/reconcile": { "post": { "tags": [ "分账结算" ], "summary": "分账结算：创建 reconcile", "description": "由源码路由表自动生成。真实挂载路径：`/api/settlements/reconcile`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "period_month": { "description": "类型 String, fee_pct: Option（未能自动映射）" } }, "additionalProperties": true, "required": [ "period_month" ], "description": "由源码结构体 `ReconcileReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "ReconcileReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_settlements_reconcile", "x-schema-source": "derived-from-struct" } }, "/api/settlements/{id}/settle": { "post": { "tags": [ "分账结算" ], "summary": "分账结算：创建 settle（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/settlements/{id}/settle`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_settlements_id_settle" } }, "/api/site2app/generate": { "post": { "tags": [ "网站转应用" ], "summary": "网站转应用：创建 generate", "description": "由源码路由表自动生成。真实挂载路径：`/api/site2app/generate`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "project": { "type": "string" }, "app_name": { "type": "string" }, "platforms": { "type": "object", "properties": { "mp": { "type": "boolean" }, "app": { "type": "boolean" }, "exe": { "type": "boolean" } }, "additionalProperties": true } }, "additionalProperties": true, "required": [ "project" ], "description": "由源码结构体 `GenerateReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "GenerateReq", "x-struct-definitions": 2 } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_site2app_generate", "x-schema-source": "derived-from-struct" } }, "/api/site2app/jobs": { "get": { "tags": [ "网站转应用" ], "summary": "网站转应用：查询任务", "description": "由源码路由表自动生成。真实挂载路径：`/api/site2app/jobs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_site2app_jobs" } }, "/api/site2app/jobs/{id}": { "delete": { "tags": [ "网站转应用" ], "summary": "任务：按 id 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/site2app/jobs/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "delete_api_site2app_jobs_id" }, "get": { "tags": [ "网站转应用" ], "summary": "任务：按 id 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/site2app/jobs/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_site2app_jobs_id" }, "put": { "tags": [ "网站转应用" ], "summary": "任务：按 id 更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/site2app/jobs/{id}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "pricing_mode": { "type": "string" }, "price_cents": { "type": "integer" }, "currency": { "type": "string" }, "source_meta": { "type": "string" } }, "additionalProperties": true, "description": "由源码结构体 `UpdateArtifactReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "UpdateArtifactReq" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "put_api_site2app_jobs_id", "x-schema-source": "derived-from-struct" } }, "/api/site2app/jobs/{id}/artifact/{platform}": { "get": { "tags": [ "网站转应用" ], "summary": "artifact：按 platform 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/site2app/jobs/{id}/artifact/{platform}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" }, { "name": "platform", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：platform" } ], "operationId": "get_api_site2app_jobs_id_artifact_platform" } }, "/api/site2app/jobs/{id}/build": { "post": { "tags": [ "网站转应用" ], "summary": "网站转应用：执行构建（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/site2app/jobs/{id}/build`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "target_id": { "type": "integer" }, "plugin_code": { "type": "string" } }, "additionalProperties": true, "required": [ "target_id" ], "description": "由源码结构体 `TriggerReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "TriggerReq", "x-struct-definitions": 2 } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_site2app_jobs_id_build", "x-schema-source": "derived-from-struct" } }, "/api/site2app/jobs/{id}/export": { "get": { "tags": [ "网站转应用" ], "summary": "网站转应用：查询导出（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/site2app/jobs/{id}/export`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "operationId": "get_api_site2app_jobs_id_export" } }, "/api/sync/conflicts": { "get": { "tags": [ "数据同步" ], "summary": "数据同步：查询冲突", "description": "由源码路由表自动生成。真实挂载路径：`/api/sync/conflicts`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_sync_conflicts" } }, "/api/sync/conflicts/{id}/resolve": { "post": { "tags": [ "数据同步" ], "summary": "数据同步：创建 resolve（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/sync/conflicts/{id}/resolve`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_sync_conflicts_id_resolve" } }, "/api/sync/pull": { "get": { "tags": [ "数据同步" ], "summary": "数据同步：查询拉取", "description": "由源码路由表自动生成。真实挂载路径：`/api/sync/pull`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_sync_pull" } }, "/api/sync/push": { "post": { "tags": [ "数据同步" ], "summary": "数据同步：执行推送", "description": "由源码路由表自动生成。真实挂载路径：`/api/sync/push`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "client_id": { "type": "string" }, "plugin_code": { "type": "string" }, "sync_type": { "type": "string" }, "operations": { "type": "array", "items": { "type": "object", "properties": { "action": { "type": "string" }, "collection": { "type": "string" }, "doc_id": { "type": "string" }, "key_name": { "type": "string" }, "payload": { "type": "string" }, "client_ts": { "type": "integer" } }, "additionalProperties": true, "required": [ "action", "client_ts" ] } } }, "additionalProperties": true, "required": [ "client_id", "plugin_code", "operations" ], "description": "由源码结构体 `SyncPushReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "SyncPushReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_sync_push", "x-schema-source": "derived-from-struct" } }, "/api/sync/status": { "get": { "tags": [ "数据同步" ], "summary": "数据同步：查询状态", "description": "由源码路由表自动生成。真实挂载路径：`/api/sync/status`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_sync_status" } }, "/api/system/logs": { "get": { "tags": [ "系统管理" ], "summary": "系统管理：查询日志", "description": "由源码路由表自动生成。真实挂载路径：`/api/system/logs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_system_logs" } }, "/api/system/metrics": { "get": { "tags": [ "系统管理" ], "summary": "系统管理：查询指标", "description": "由源码路由表自动生成。真实挂载路径：`/api/system/metrics`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_system_metrics" } }, "/api/system/monitor": { "get": { "tags": [ "系统管理" ], "summary": "系统管理：查询 monitor", "description": "由源码路由表自动生成。真实挂载路径：`/api/system/monitor`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_system_monitor" } }, "/api/system/restart": { "post": { "tags": [ "系统管理" ], "summary": "系统管理：执行重启", "description": "由源码路由表自动生成。真实挂载路径：`/api/system/restart`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_system_restart" } }, "/api/tier-policy/audit": { "get": { "tags": [ "接口层级权限" ], "summary": "接口层级权限：查询审计", "description": "由源码路由表自动生成。真实挂载路径：`/api/tier-policy/audit`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_tier_policy_audit" } }, "/api/tier-policy/batch": { "post": { "tags": [ "接口层级权限" ], "summary": "接口层级权限：创建批量", "description": "由源码路由表自动生成。真实挂载路径：`/api/tier-policy/batch`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "tier": { "type": "string" }, "group_key": { "type": "string" }, "allowed": { "type": "boolean" } }, "additionalProperties": true, "required": [ "tier", "group_key", "allowed" ] } }, "note": { "type": "string" } }, "additionalProperties": true, "required": [ "items" ], "description": "由源码结构体 `BatchPolicyReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "BatchPolicyReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_tier_policy_batch", "x-schema-source": "derived-from-struct" } }, "/api/tier-policy/overview": { "get": { "tags": [ "接口层级权限" ], "summary": "接口层级权限：查询概览", "description": "由源码路由表自动生成。真实挂载路径：`/api/tier-policy/overview`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_tier_policy_overview" } }, "/api/tier-policy/plugins": { "get": { "tags": [ "接口层级权限" ], "summary": "接口层级权限：查询 plugins", "description": "由源码路由表自动生成。真实挂载路径：`/api/tier-policy/plugins`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_tier_policy_plugins" } }, "/api/tier-policy/plugins/{code}/approve": { "post": { "tags": [ "接口层级权限" ], "summary": "接口层级权限：执行批准（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/tier-policy/plugins/{code}/approve`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_tier_policy_plugins_code_approve" } }, "/api/tier-policy/plugins/{code}/reject": { "post": { "tags": [ "接口层级权限" ], "summary": "接口层级权限：执行驳回（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/tier-policy/plugins/{code}/reject`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_tier_policy_plugins_code_reject" } }, "/api/tier-policy/plugins/{code}/tier": { "post": { "tags": [ "接口层级权限" ], "summary": "接口层级权限：创建 tier（按 code 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/tier-policy/plugins/{code}/tier`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_tier_policy_plugins_code_tier" } }, "/api/tier-policy/snapshots": { "get": { "tags": [ "接口层级权限" ], "summary": "接口层级权限：查询快照", "description": "由源码路由表自动生成。真实挂载路径：`/api/tier-policy/snapshots`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_tier_policy_snapshots" }, "post": { "tags": [ "接口层级权限" ], "summary": "接口层级权限：创建快照", "description": "由源码路由表自动生成。真实挂载路径：`/api/tier-policy/snapshots`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": "string" } }, "additionalProperties": true, "description": "由源码结构体 `SnapshotReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "SnapshotReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_tier_policy_snapshots", "x-schema-source": "derived-from-struct" } }, "/api/tier-policy/snapshots/{id}/rollback": { "post": { "tags": [ "接口层级权限" ], "summary": "接口层级权限：执行回滚（按 id 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/tier-policy/snapshots/{id}/rollback`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "路径参数：记录标识" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "post_api_tier_policy_snapshots_id_rollback" } }, "/api/trace/logs": { "get": { "tags": [ "链路追踪" ], "summary": "链路追踪：查询日志", "description": "由源码路由表自动生成。真实挂载路径：`/api/trace/logs`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_trace_logs" } }, "/api/trace/overview": { "get": { "tags": [ "链路追踪" ], "summary": "链路追踪：查询概览", "description": "由源码路由表自动生成。真实挂载路径：`/api/trace/overview`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_trace_overview" } }, "/api/trace/track": { "post": { "tags": [ "链路追踪" ], "summary": "链路追踪：创建 track", "description": "由源码路由表自动生成。真实挂载路径：`/api/trace/track`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_trace_track" } }, "/api/ucenter/sync": { "post": { "tags": [ "用户中心" ], "summary": "用户中心：执行同步", "description": "由源码路由表自动生成。真实挂载路径：`/api/ucenter/sync`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_ucenter_sync" } }, "/api/ucenter/users": { "get": { "tags": [ "用户中心" ], "summary": "用户中心：查询用户", "description": "由源码路由表自动生成。真实挂载路径：`/api/ucenter/users`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [], "operationId": "get_api_ucenter_users" } }, "/api/ups/register": { "post": { "tags": [ "升级服务" ], "summary": "升级服务：创建 register", "description": "由源码路由表自动生成。真实挂载路径：`/api/ups/register`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_ups_register" } }, "/api/ups/send": { "post": { "tags": [ "升级服务" ], "summary": "升级服务：创建 send", "description": "由源码路由表自动生成。真实挂载路径：`/api/ups/send`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string" }, "body": { "type": "string" }, "data": { "description": "任意 JSON" }, "targets": { "type": "array", "items": { "type": "string" } }, "channel": { "type": "string" } }, "additionalProperties": true, "description": "由源码结构体 `SendPushReq` 派生（字段与类型来自 serde 定义），未逐项运行时校验；属内部管理接口，不承诺外部兼容。", "x-derived-from": "SendPushReq" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_ups_send", "x-schema-source": "derived-from-struct" } }, "/api/webhook": { "post": { "tags": [ "回调通知" ], "summary": "回调通知：创建", "description": "由源码路由表自动生成。真实挂载路径：`/api/webhook`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "parameters": [], "x-contract-status": "internal-admin-generic", "operationId": "post_api_webhook" } }, "/api/webhook/inbox/{code}": { "post": { "tags": [ "回调通知" ], "summary": "inbox：按 code 操作", "description": "公开的插件事件收件箱。插件必须存在；按 IP 限流；payload 上限 256 KiB。这不是插件代理路径。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookInboxReq" } } } }, "security": [], "operationId": "post_api_webhook_inbox_code" } }, "/api/protocols": { "get": { "summary": "协议清单", "description": "返回本平台支持的全部 API 协议入口、端点与状态。AI 可据此发现能力。", "tags": [ "协议网关" ], "responses": { "200": { "description": "OK" } }, "parameters": [], "operationId": "get_api_protocols" } }, "/api/rpc": { "post": { "summary": "JSON-RPC 2.0", "description": "标准 JSON-RPC 2.0 端点。method 支持 system.health / plugins.list / plugins.get / market.list / db.tables / http.request（万能兜底，params={method,path,body}）。支持批量数组。", "tags": [ "协议网关" ], "responses": { "200": { "description": "OK" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "jsonrpc": { "type": "string", "example": "2.0" }, "id": {}, "method": { "type": "string" }, "params": { "type": "object" } }, "required": [ "method" ] } } } }, "parameters": [], "operationId": "post_api_rpc" } }, "/api/mcp": { "post": { "summary": "MCP (Model Context Protocol)", "description": "MCP over HTTP。方法：initialize / tools/list / tools/call。工具名以 cfapi_ 前缀，cfapi_http 可调用任意 REST 端点。", "tags": [ "协议网关" ], "responses": { "200": { "description": "OK" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "jsonrpc": { "type": "string" }, "id": {}, "method": { "type": "string", "enum": [ "initialize", "tools/list", "tools/call", "ping" ] }, "params": { "type": "object" } } } } } }, "parameters": [], "operationId": "post_api_mcp" } }, "/connect/{service}/{method}": { "post": { "summary": "Connect (spec-compliant)", "description": "严格遵循 https://connectrpc.com/docs/protocol 的 Connect 一元 RPC。\n\n路径：`/{routing-prefix}/{package}.{Service}/{Method}`，例如 `POST /connect/cfapi.v1.PluginService/List`。\nCodec：`application/json`（proto3 JSON 映射）或 `application/proto`（protobuf 二进制）。\n响应体是**裸消息**（无 result 包装）；错误返回**非 200** + `application/json` + `{code,message}`。\n支持 GET：`?message=&encoding=json&connect=v1`（仅无副作用方法）。\n服务端流式：请求/响应 `application/connect+json` 或 `application/connect+proto`，每条消息为 1 字节 flags + 4 字节大端长度 + 消息体，末帧 flags 位 1 置位（EndStream）。\n\n服务：`cfapi.v1.SystemService`（Health / Version / Watch[流式]）、`cfapi.v1.PluginService`（List / Get）、`cfapi.v1.GatewayService`（Call）。\nIDL 下载：`GET /api/protocols/cfapi.proto`，用 connect-go / connect-es / connect-py 生成客户端。", "tags": [ "协议网关" ], "parameters": [ { "name": "service", "in": "path", "required": true, "schema": { "type": "string" }, "example": "cfapi.v1.PluginService" }, { "name": "method", "in": "path", "required": true, "schema": { "type": "string" }, "example": "List" } ], "responses": { "200": { "description": "成功，响应体为该方法的 protobuf/JSON 消息" }, "400": { "description": "invalid_argument" }, "401": { "description": "unauthenticated" }, "404": { "description": "not_found" }, "501": { "description": "unimplemented（方法不存在）" } }, "operationId": "post_connect_service_method" }, "get": { "summary": "Connect unary (GET, 无副作用方法)", "description": "规范要求的 GET 形式：`?message=&encoding=json&connect=v1`。仅适用于无副作用方法（Health/Version/List/Get）。", "tags": [ "协议网关" ], "parameters": [ { "name": "service", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "method", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "encoding", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "json" ] } }, { "name": "connect", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "v1" ] } } ], "responses": { "200": { "description": "成功" } }, "operationId": "get_connect_service_method" } }, "/api/protocols/cfapi.proto": { "get": { "summary": "下载 .proto IDL", "description": "返回 protobuf IDL 原文，供 connect-go / connect-es / connect-py 生成客户端代码。", "tags": [ "协议网关" ], "responses": { "200": { "description": "text/plain，cfapi.proto 全文" } }, "parameters": [], "operationId": "get_api_protocols_cfapi_proto" } }, "/api/_storage/{bucket}/{key}": { "delete": { "tags": [ "插件对象存储（面向插件）" ], "summary": "bucket：按 key:.* 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/_storage/{bucket}/{key:.*}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "bucket", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：bucket" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 key" } ], "operationId": "delete_api_storage_bucket_key" }, "get": { "tags": [ "插件对象存储（面向插件）" ], "summary": "bucket：按 key:.* 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/_storage/{bucket}/{key:.*}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "bucket", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：bucket" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 key" } ], "operationId": "get_api_storage_bucket_key" }, "put": { "tags": [ "插件对象存储（面向插件）" ], "summary": "bucket：按 key:.* 更新", "description": "由源码路由表自动生成。真实挂载路径：`/api/_storage/{bucket}/{key:.*}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "bucket", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：bucket" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 key" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "内部/管理接口的请求体在源码中未结构化或由后台页面定义。外部插件不应依赖；接入内部能力前请查源码或向平台确认。" } } } }, "x-contract-status": "internal-admin-generic", "operationId": "put_api_storage_bucket_key" } }, "/api/plugin-storage/buckets/{bucket}/objects/{key}/download": { "get": { "tags": [ "插件对象存储管理" ], "summary": "插件对象存储管理：查询下载（按 bucket、key:.* 定位）", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugin-storage/buckets/{bucket}/objects/{key:.*}/download`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "bucket", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：bucket" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 key" } ], "operationId": "get_api_plugin_storage_buckets_bucket_objects_key_download" } }, "/api/plugins/{code}/files/download/{path}": { "get": { "tags": [ "插件" ], "summary": "下载：按 path:.* 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/files/download/{path:.*}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "path", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 path" } ], "operationId": "get_api_plugins_code_files_download_path" } }, "/api/plugins/{code}/files/{path}": { "delete": { "tags": [ "插件" ], "summary": "文件：按 path:.* 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/files/{path:.*}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "path", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 path" } ], "operationId": "delete_api_plugins_code_files_path" } }, "/api/plugins/{code}/storage/objects/{key}": { "delete": { "tags": [ "插件" ], "summary": "对象：按 key:.* 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/storage/objects/{key:.*}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 key" } ], "operationId": "delete_api_plugins_code_storage_objects_key" }, "get": { "tags": [ "插件管理" ], "summary": "对象：按 key:.* 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/storage/objects/{key:.*}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 key" } ], "operationId": "get_api_plugins_code_storage_objects_key" }, "put": { "tags": [ "插件管理" ], "summary": "对象：按 key:.* 更新", "description": "以原始字节写入插件私有对象存储。需要 plugin.manage；key 支持多级路径；受单对象与总容量策略限制。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 key" } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "operationId": "put_api_plugins_code_storage_objects_key" } }, "/api/plugins/{code}/store/{key}": { "delete": { "tags": [ "插件" ], "summary": "store：按 key:.* 删除", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/store/{key:.*}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 key" } ], "operationId": "delete_api_plugins_code_store_key" }, "get": { "tags": [ "插件管理" ], "summary": "store：按 key:.* 获取详情", "description": "由源码路由表自动生成。真实挂载路径：`/api/plugins/{code}/store/{key:.*}`（同时可用 `/api/v1` 前缀）。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 key" } ], "operationId": "get_api_plugins_code_store_key" }, "put": { "tags": [ "插件管理" ], "summary": "store：按 key:.* 更新", "description": "写入数据岛内的键值。value 为字符串；namespace 缺省 default。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：code" }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 key" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DataStorePutReq" } } } }, "operationId": "put_api_plugins_code_store_key" } }, "/api/plugins/{from}/call/{to}/{path}": { "post": { "tags": [ "插件" ], "summary": "to：按 path:.* 操作", "description": "显式授权的跨插件调用。需要 plugin.manage；from→to/method 必须存在于 plugin_rpc_grants；目标必须是启用的 remote 插件。", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "未认证或令牌无效" }, "403": { "description": "权限不足，或接口层级不允许（外部层级访问内部专属能力）" } }, "parameters": [ { "name": "from", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：from" }, { "name": "to", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数：to" }, { "name": "path", "in": "path", "required": true, "schema": { "type": "string" }, "description": "路径参数 path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterPluginCallReq" } } } }, "operationId": "post_api_plugins_from_call_to_path" } }, "/api/market/upload": { "post": { "tags": [ "插件市场" ], "summary": "市场投稿：上传插件 ZIP（multipart/form-data，字段名 file）", "description": "任意有效登录用户可调用，不需要 plugin.manage。plugin_code 只能小写字母/数字/下划线；ZIP 上限 500 MB；已归属他人或平台的插件只有超管可覆盖。成功返回 download_url，但尚未提交审核。", "security": [ { "bearer": [] } ], "parameters": [ { "name": "plugin_code", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9_]{1,64}$" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "file" ], "properties": { "file": { "type": "string", "format": "binary" } } } } } }, "responses": { "200": { "description": "上传成功，返回 download_url", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": {} } } } } }, "400": { "description": "参数错误" }, "401": { "description": "未认证" }, "403": { "description": "无权限" } }, "x-required-permission": "authenticated", "operationId": "post_api_market_upload" } }, "/api/plugins/templates": { "get": { "tags": [ "插件" ], "summary": "已公布的可下载模板插件列表（公开）", "description": "返回 status=1、approval_status=approved、is_template=1 的插件模板；不是所有市场插件。", "security": [], "responses": { "200": { "description": "模板列表", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": {} } } } } }, "400": { "description": "参数错误" }, "401": { "description": "未认证" }, "403": { "description": "无权限" } }, "operationId": "get_api_plugins_templates" } }, "/api/plugins/callable": { "get": { "tags": [ "插件" ], "summary": "可调用插件目录（需登录）", "description": "返回 approved 且已启用的插件元数据。注意：目录可见不等于可调用；proxy 仅支持 remote + base_url，且读/写分别需要 plugin.view/plugin.manage。", "security": [ { "bearer": [] } ], "responses": { "200": { "description": "目录列表", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": {} } } } } }, "400": { "description": "参数错误" }, "401": { "description": "未认证" }, "403": { "description": "无权限" } }, "operationId": "get_api_plugins_callable" } }, "/api/plugins/{code}/export-template": { "get": { "tags": [ "插件" ], "summary": "下载已公布模板插件源码 ZIP（公开）", "description": "仅 is_template=1、status=1、approval_status=approved 的插件可导出；其他情况 404。", "security": [], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9_]{1,64}$" } } ], "responses": { "200": { "description": "ZIP 二进制", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "404": { "description": "不是已公布模板或不存在" } }, "operationId": "get_api_plugins_code_export_template" } }, "/api/plugins/{code}/signing-secret": { "get": { "tags": [ "插件" ], "summary": "取得本插件的代理验签密钥（需 plugin.manage + 归属）", "description": "返回按 plugin_code 派生的 HMAC-SHA256 密钥，用于校验 X-Platform-Signature / X-Platform-Caller-Signature。不返回平台全局密钥。仅归属人或超管可读；响应 no-store。", "security": [ { "bearer": [] } ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9_]{1,64}$" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "secret_algorithm": { "type": "string", "example": "HMAC-SHA256" }, "plugin_secret": { "type": "string", "description": "按插件派生的验签密钥；不得写入前端或公开仓库" }, "signature_headers": { "type": "object" }, "rotation_note": { "type": "string" } } } } } } } }, "403": { "description": "缺少 plugin.manage 或非插件归属人" }, "404": { "description": "插件不存在" } }, "x-required-permission": "plugin.manage", "operationId": "get_api_plugins_code_signing_secret" } }, "/api/market/submissions/{code}/signing-secret": { "get": { "tags": [ "插件市场" ], "summary": "市场开发者取得自己已批准插件的验签密钥", "description": "仅原始提交者本人或超管可读，且提交状态必须为 approved。返回按 plugin_code 派生的密钥，不是平台全局密钥。用于 remote 插件验证 X-Platform-Signature。", "security": [ { "bearer": [] } ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9_]{1,64}$" } } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": { "type": "object", "properties": { "plugin_code": { "type": "string" }, "secret_algorithm": { "type": "string", "example": "HMAC-SHA256" }, "plugin_secret": { "type": "string", "description": "按插件派生的验签密钥；不得写入前端或公开仓库" }, "signature_headers": { "type": "object" }, "rotation_note": { "type": "string" } } } } } } } }, "403": { "description": "非提交者、非超管，或状态不是 approved" }, "404": { "description": "没有市场提交记录" } }, "x-required-permission": "authenticated-owner", "operationId": "get_api_market_submissions_code_signing_secret" } }, "/api/market/submissions/{code}/withdraw": { "post": { "summary": "撤回待审的市场提交", "description": "仅提交者本人或超管可撤回，且仅当状态为 pending。撤回是删除动作：该提交记录会被移除，市场不会保留草稿；需要重新提交请走 POST /api/market/submit。已 approved / rejected 的提交不能撤回。", "tags": [ "插件市场" ], "security": [ { "bearer": [] } ], "responses": { "200": { "description": "撤回成功", "content": { "application/json": { "example": { "code": 0, "message": "已撤回该插件的待审提交", "data": null } } } }, "400": { "description": "当前状态不是 pending（40000）" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "description": "该插件没有提交记录（40400）" } }, "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9_]{1,64}$" } } ], "operationId": "post_api_market_submissions_code_withdraw" } }, "/api/plugins/mine": { "get": { "summary": "列出我名下的插件与最近提交状态", "description": "返回当前登录账号作为归属人的插件，以及每个插件的最近一次市场提交状态（pending / approved / rejected）与审核备注。只读，不受 plugin.view 限制，任何登录账号都只能看到自己的。", "tags": [ "插件" ], "security": [ { "bearer": [] } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": { "items": [ { "code": "demo", "name": "示例", "ptype": "local", "status": 1, "approval_status": "approved", "submission": { "status": "approved", "review_notes": null } } ], "total": 1 } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } }, "operationId": "get_api_plugins_mine" } }, "/api/plugins/categories": { "get": { "summary": "列出插件分类", "description": "按层级（external / internal）读取分类，用于市场投稿时选择 category。需要 plugin.view。", "tags": [ "插件" ], "security": [ { "bearer": [] } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": null } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } }, "x-required-permission": "plugin.view", "parameters": [ { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "external", "internal" ] } } ], "operationId": "get_api_plugins_categories" }, "post": { "summary": "新建插件分类", "description": "需要 plugin.manage。body 至少包含 tier 与 name（≤128 字符），可选 sort_order。分类是平台级配置，普通开发者无此权限。", "tags": [ "插件" ], "security": [ { "bearer": [] } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": null } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } }, "x-required-permission": "plugin.manage", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "tier", "name" ], "properties": { "tier": { "type": "string", "enum": [ "external", "internal" ] }, "name": { "type": "string", "maxLength": 128 }, "sort_order": { "type": "integer" } } } } } }, "operationId": "post_api_plugins_categories" } }, "/api/plugins/{code}/submit-review": { "post": { "summary": "把自有插件提交审核（旧版私有链路）", "description": "需要 plugin.manage 且为插件归属人。仅用于内部私有插件的审核状态流转；外部开发者发布请走市场链路（POST /api/market/upload → POST /api/market/submit），不要使用本接口。已 approved 的插件再次提交会返回 400。", "tags": [ "插件" ], "security": [ { "bearer": [] } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "example": { "code": 0, "message": "ok", "data": null } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/TooManyRequests" } }, "x-required-permission": "plugin.manage", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "post_api_plugins_code_submit_review" } }, "/api/plugins/tree": { "get": { "tags": [ "插件层级" ], "summary": "插件层级树", "description": "返回以 cfapi 为根的层级树。depth=1 为总插件平台，depth=2 为一级子插件平台，依此类推。", "operationId": "pluginTree", "responses": { "200": { "description": "统一响应体 {code,message,data}" }, "400": { "description": "40000 参数错误" }, "403": { "description": "40300 不在授权子树内" } }, "x-required-permission": "plugin.view", "parameters": [ { "name": "root", "in": "query", "schema": { "type": "string" }, "description": "以该插件为根渲染其整棵子树" }, { "name": "max_depth", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 16 }, "description": "最多展开层数（相对整棵树）" } ] } }, "/api/plugins/{code}/children": { "get": { "tags": [ "插件层级" ], "summary": "列出直接子节点", "description": "只返回下一层，不含更深后代。", "operationId": "pluginChildren", "responses": { "200": { "description": "统一响应体 {code,message,data}" }, "400": { "description": "40000 参数错误" }, "403": { "description": "40300 不在授权子树内" } }, "x-required-permission": "plugin.view", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "插件 code" } ] }, "post": { "tags": [ "插件层级" ], "summary": "新建子节点", "description": "在指定插件下挂一个子插件/子插件平台。父节点必须 is_platform=1。", "operationId": "pluginCreateChild", "responses": { "200": { "description": "统一响应体 {code,message,data}" }, "400": { "description": "40000 参数错误" }, "403": { "description": "40300 不在授权子树内" } }, "x-required-permission": "plugin.manage", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "插件 code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "string" }, "name": { "type": "string" }, "version": { "type": "string" }, "type": { "type": "string", "enum": [ "local", "remote", "wasm", "sandbox" ] }, "base_url": { "type": "string" }, "kind": { "type": "string", "enum": [ "native", "api", "code", "db", "wasm", "sandbox" ], "description": "接入形态：对端有 API 用 api；只能改代码用 code；只能连库用 db" }, "is_platform": { "type": "boolean" }, "manage_mode": { "type": "string", "enum": [ "inherit", "delegated" ] }, "manifest": { "type": "object" } } } } } } } }, "/api/plugins/{code}/descendants": { "get": { "tags": [ "插件层级" ], "summary": "列出全部后代", "description": "越级视角：一次拿到该节点下任意深度的所有子孙，按层级升序。", "operationId": "pluginDescendants", "responses": { "200": { "description": "统一响应体 {code,message,data}" }, "400": { "description": "40000 参数错误" }, "403": { "description": "40300 不在授权子树内" } }, "x-required-permission": "plugin.view", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "插件 code" }, { "name": "max_depth", "in": "query", "schema": { "type": "integer", "minimum": 1 } } ] } }, "/api/plugins/{code}/lineage": { "get": { "tags": [ "插件层级" ], "summary": "祖先链（面包屑）", "description": "从 cfapi 根到该节点的完整链条，含每层的中文层级名。", "operationId": "pluginLineage", "responses": { "200": { "description": "统一响应体 {code,message,data}" }, "400": { "description": "40000 参数错误" }, "403": { "description": "40300 不在授权子树内" } }, "x-required-permission": "plugin.view", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "插件 code" } ] } }, "/api/plugins/{code}/parent": { "put": { "tags": [ "插件层级" ], "summary": "改挂父节点", "description": "把节点（含整棵子树）移动到另一个父下。会拒绝把节点挂到自己的子孙下（防环），并校验深度上限 16。", "operationId": "pluginReparent", "responses": { "200": { "description": "统一响应体 {code,message,data}" }, "400": { "description": "40000 参数错误" }, "403": { "description": "40300 不在授权子树内" } }, "x-required-permission": "plugin.manage", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "插件 code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "parent": { "type": "string", "description": "新父 code；空串或 0 表示提升为总插件平台" } } } } } } } }, "/api/plugins/{code}/platform": { "post": { "tags": [ "插件层级" ], "summary": "开关插件平台能力", "description": "is_platform=1 表示该节点可以继续挂子节点。关闭前必须先移走/删除所有子节点。", "operationId": "pluginSetPlatform", "responses": { "200": { "description": "统一响应体 {code,message,data}" }, "400": { "description": "40000 参数错误" }, "403": { "description": "40300 不在授权子树内" } }, "x-required-permission": "plugin.manage", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "插件 code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "is_platform" ], "properties": { "is_platform": { "type": "boolean" }, "manage_mode": { "type": "string", "enum": [ "inherit", "delegated" ] } } } } } } } }, "/api/plugins/{code}/protocols": { "get": { "tags": [ "插件层级" ], "summary": "该节点的协议清单", "description": "返回 20 种协议的节点级入口（HTTP/REST/JSON-RPC/MCP/Connect/gRPC-Web/GraphQL/WebSocket/SSE/Webhook/CLI/OpenAPI/OAuth2/OIDC/JWT/APIKey/AdminAPI/Metrics/HealthCheck/SAML2）及鉴权方式。", "operationId": "pluginProtocols", "responses": { "200": { "description": "统一响应体 {code,message,data}" }, "400": { "description": "40000 参数错误" }, "403": { "description": "40300 不在授权子树内" } }, "x-required-permission": "plugin.view", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "插件 code" } ] } }, "/api/plugins/{code}/tokens": { "post": { "tags": [ "插件层级" ], "summary": "签发平台作用域令牌", "description": "签发只能管理该插件及其整棵子树的管理令牌（Claims.pscope）。令牌恒非超管，越出子树一律 403。", "operationId": "pluginIssueScopeToken", "responses": { "200": { "description": "统一响应体 {code,message,data}" }, "400": { "description": "40000 参数错误" }, "403": { "description": "40300 不在授权子树内" } }, "x-required-permission": "plugin.manage", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "插件 code" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "expire_hours": { "type": "integer", "minimum": 1, "maximum": 720, "default": 24 } } } } } } } } }, "tags": [ { "name": "Anthropic 兼容接口", "description": "兼容 Anthropic 协议的模型调用" }, { "name": "OpenAI 兼容接口", "description": "兼容 OpenAI 协议的模型调用" }, { "name": "OpenRouter 兼容接口", "description": "兼容 OpenRouter 协议的模型调用" }, { "name": "事件总线", "description": "事件发布与投递" }, { "name": "云函数", "description": "函数的部署、调用与日志" }, { "name": "代理转发", "description": "反向代理规则与访问日志" }, { "name": "仪表盘", "description": "首页汇总数据" }, { "name": "任务队列", "description": "异步任务的投递、重试与查询" }, { "name": "信用评分", "description": "插件与开发者信用分" }, { "name": "健康检查", "description": "存活探针" }, { "name": "公开接口", "description": "无需登录即可访问的公共数据" }, { "name": "分账结算", "description": "结算单生成与执行" }, { "name": "升级服务", "description": "版本检查与升级包分发" }, { "name": "协议网关", "description": "图数据、长连接、实时通道开关" }, { "name": "单点登录（SAML）", "description": "SAML 2.0 身份提供方对接" }, { "name": "可观测性", "description": "监控指标、熔断器与告警" }, { "name": "后台用户管理", "description": "管理员对用户的增删改查与角色分配" }, { "name": "商品", "description": "售卖商品定义" }, { "name": "回调通知", "description": "第三方回调接收" }, { "name": "备份与恢复", "description": "数据库与文件备份、还原" }, { "name": "多语言", "description": "语言包与翻译条目" }, { "name": "安全扫描", "description": "插件包与依赖的安全检测" }, { "name": "应用注册", "description": "终端应用注册与登记" }, { "name": "开放授权", "description": "OAuth 2.0 授权码、令牌、内省与客户端管理" }, { "name": "持续集成部署", "description": "代码仓库配置、流水线与运行记录" }, { "name": "接口密钥", "description": "密钥签发与层级授权" }, { "name": "接口层级权限", "description": "内部/外部双层级能力白名单、插件审批与快照回滚" }, { "name": "接口文档", "description": "在线接口浏览器" }, { "name": "接口文档", "description": "接口规范文件" }, { "name": "控制台配置", "description": "后台站点标题、菜单与外观" }, { "name": "插件事件内核", "description": "事件钩子、界面插槽与内核扩展点" }, { "name": "插件对象存储管理", "description": "存储桶、对象与访问策略" }, { "name": "插件对象存储（面向插件）", "description": "插件运行时可直接调用的对象存储接口" }, { "name": "插件市场", "description": "插件上架、审核、评分与安装" }, { "name": "插件数据存储", "description": "插件专属集合、文档与键值存储" }, { "name": "插件沙箱", "description": "受限执行环境的配置与运行记录" }, { "name": "插件清单", "description": "清单解析与权限声明" }, { "name": "插件管理", "description": "插件的安装、启用、代理转发与市场分发" }, { "name": "支付意图", "description": "支付单创建与确认" }, { "name": "数据同步", "description": "多端数据同步与冲突解决" }, { "name": "数据库管理", "description": "表结构浏览与在线查询" }, { "name": "数据清理", "description": "按类别清理历史数据" }, { "name": "构建与分发", "description": "客户端构建目标、证书、构建任务与产物" }, { "name": "版本信息", "description": "服务版本号" }, { "name": "用户中心", "description": "面向终端用户的账户接口" }, { "name": "用户管理", "description": "用户的增删改查与状态" }, { "name": "用量计量", "description": "调用量统计与配额" }, { "name": "签名公证", "description": "公钥管理与内容签名校验" }, { "name": "系统管理", "description": "系统信息、在线升级与运行状态" }, { "name": "系统设置", "description": "键值型全局配置" }, { "name": "网站转应用", "description": "把网站打包为多平台客户端" }, { "name": "自有应用打包", "description": "自有应用的多端构建" }, { "name": "角色与权限", "description": "角色、权限点与部门" }, { "name": "计费与账单", "description": "订阅、用量、发票与收入" }, { "name": "认证登录", "description": "登录、登出、资料与密码" }, { "name": "身份与访问控制", "description": "租户、属性策略、权限委派与远程调用授权" }, { "name": "运维操作", "description": "命令日志与运维动作" }, { "name": "钩子链", "description": "钩子的注册、启停与测试" }, { "name": "链路追踪", "description": "调用链与风险日志" }, { "name": "风险控制", "description": "风险评估、事件与人工解除" }, { "name": "公共", "description": "无需登录的公开端点（版本、健康检查、验证码）。" }, { "name": "认证", "description": "登录、登出、资料与改密。平台不提供公开的开发者自助注册接口，账号由管理员创建。" }, { "name": "后台账号", "description": "后台管理员账号的增删改查与状态管理，需管理类权限。" }, { "name": "角色权限", "description": "RBAC 角色、权限点与部门维护。" }, { "name": "部门", "description": "组织架构与部门归属。" }, { "name": "业务用户", "description": "前台业务用户（应用侧账号）的注册、登录与管理，与插件自有用户不是同一套体系。" }, { "name": "插件", "description": "插件注册、上传、启停、归属、分类、代理与数据面。" }, { "name": "系统", "description": "系统信息、升级与运维状态，权限最高。" }, { "name": "插件层级", "description": "cfapi > 总插件平台 > 一级子插件平台 > 二级 > 三级 > 无限下级。上级可越级管理任意深度的子孙；也可签发 pscope 令牌让子平台自治其子树。" } ], "x-devcenter-docs": { "docs_version": "2026.11.05-r1", "human": "/docs/devcenter/", "ai_index": "/docs/devcenter/llms.txt", "ai_full": "/docs/devcenter/llms-full.txt", "manifest_schema": "/docs/devcenter/schemas/plugin-manifest.schema.json", "retired_extra": "/docs/devcenter/openapi_extra.json" } }