{ "openapi": "3.1.0", "info": { "title": "云动 CPQ Agent API", "version": "1.0.0", "description": "当前已实现的业务、企业及平台接口。Cookie 会话认证；SaaS 写入需 CSRF。开放 JSON 对象不代表任意字段均可写入，嵌套领域对象仍由 CPQ 服务端验证。" }, "servers": [ { "url": "/", "description": "选择实际 CPQ 业务域名或平台域名；官网独立托管时请替换。" } ], "tags": [ { "name": "基础与身份" }, { "name": "产品与配置" }, { "name": "规则与 BML" }, { "name": "价格与协议" }, { "name": "商务与审批" }, { "name": "报价与界面" }, { "name": "文档与导出" }, { "name": "报告与审计" }, { "name": "连接与集成" }, { "name": "资产与订单" }, { "name": "渠道与客户门户" }, { "name": "AI 与知识" }, { "name": "账号与企业空间" }, { "name": "平台运营" }, { "name": "数据与系统管理" } ], "components": { "securitySchemes": { "Business": { "type": "apiKey", "in": "cookie", "name": "cpq_session", "description": "由登录接口设置的会话；CLI/MCP 自动维护，不是 API Key。" }, "BusinessProduction": { "type": "apiKey", "in": "cookie", "name": "__Host-cpq_session", "description": "由登录接口设置的会话；CLI/MCP 自动维护，不是 API Key。" }, "Account": { "type": "apiKey", "in": "cookie", "name": "cpq_account", "description": "由登录接口设置的会话；CLI/MCP 自动维护，不是 API Key。" }, "AccountProduction": { "type": "apiKey", "in": "cookie", "name": "__Host-cpq_account", "description": "由登录接口设置的会话；CLI/MCP 自动维护，不是 API Key。" }, "Platform": { "type": "apiKey", "in": "cookie", "name": "cpq_ops", "description": "由登录接口设置的会话；CLI/MCP 自动维护，不是 API Key。" }, "PlatformProduction": { "type": "apiKey", "in": "cookie", "name": "__Host-cpq_ops", "description": "由登录接口设置的会话；CLI/MCP 自动维护，不是 API Key。" }, "ReceiptSignature": { "type": "apiKey", "in": "header", "name": "X-CPQ-Signature", "description": "按外部连接回执规范生成的 HMAC-SHA256 签名。" }, "EmailGateway": { "type": "http", "scheme": "bearer", "description": "仅邮件网关回执使用的服务凭据。" } }, "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" }, "validationErrors": { "type": "array", "items": { "type": "object" } } }, "required": [ "error" ], "additionalProperties": true } } }, "paths": { "/api/health": { "get": { "operationId": "health.get", "summary": "服务健康检查", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "基础与身份" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/auth/status": { "get": { "operationId": "auth.status", "summary": "登录方式与启用状态", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "基础与身份" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/auth/login": { "post": { "operationId": "auth.login", "summary": "本机账号登录；优先使用 cpq auth login", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "基础与身份" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/auth/logout": { "post": { "operationId": "auth.logout", "summary": "退出本机或企业会话", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "基础与身份" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/auth/setup": { "post": { "operationId": "auth.setup", "summary": "首次初始化本机账号", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "基础与身份" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/bootstrap": { "get": { "operationId": "bootstrap.get", "summary": "工作区与当前账号的精简上下文", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "基础与身份" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/state": { "get": { "operationId": "state.get", "summary": "完整工作区状态、规则和资料", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "基础与身份" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/dashboard": { "get": { "operationId": "dashboard.get", "summary": "工作台指标与待办", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "基础与身份" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/release-status": { "get": { "operationId": "release-status.get", "summary": "目录、定价和商务发布版本", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "基础与身份" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/products": { "get": { "operationId": "products.list", "summary": "分页查询商品", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/catalog": { "get": { "operationId": "catalog.get", "summary": "读取完整产品目录草稿和版本", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/catalog/import": { "post": { "operationId": "catalog.import", "summary": "批量合并商品到目录草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/catalog/preview": { "post": { "operationId": "catalog.preview", "summary": "验证目录并运行产品配置页草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "modelId": { "type": "string" }, "catalogVersion": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "selection": { "type": "object", "additionalProperties": true }, "attributeValues": { "type": "object", "additionalProperties": true }, "arrayValues": { "type": "object", "additionalProperties": true }, "selectedProducts": { "type": "array", "items": { "type": "string" } }, "productQuantities": { "type": "object", "additionalProperties": true }, "configurationAction": { "type": "string" }, "currency": { "type": "string" }, "scenarioId": { "type": "string" }, "catalog": { "type": "object", "additionalProperties": true } }, "required": [ "catalog", "modelId" ], "additionalProperties": true } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/catalog/rich-preview": { "post": { "operationId": "catalog.rich-preview", "summary": "解析富文本内容", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/catalog/image-library": { "get": { "operationId": "catalog.image-library", "summary": "检索素材库", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/catalog/image": { "post": { "operationId": "catalog.image-upload", "summary": "上传产品图片", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "content": { "type": "string" } }, "required": [ "content" ], "additionalProperties": true } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/catalog/images/{filename}": { "get": { "operationId": "catalog.image-download", "summary": "读取已上传图片", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "filename", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/configure": { "post": { "operationId": "configure.run", "summary": "运行已发布产品配置、布局与规则", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "modelId": { "type": "string" }, "catalogVersion": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "selection": { "type": "object", "additionalProperties": true }, "attributeValues": { "type": "object", "additionalProperties": true }, "arrayValues": { "type": "object", "additionalProperties": true }, "selectedProducts": { "type": "array", "items": { "type": "string" } }, "productQuantities": { "type": "object", "additionalProperties": true }, "configurationAction": { "type": "string" }, "currency": { "type": "string" }, "scenarioId": { "type": "string" } }, "required": [], "additionalProperties": true } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/calculators/compute": { "post": { "operationId": "calculators.compute", "summary": "执行属性计算器", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/calculators/preview": { "post": { "operationId": "calculators.preview", "summary": "预览计算器草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/config-tables": { "post": { "operationId": "config-tables.save", "summary": "保存配置查找表", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/rules": { "post": { "operationId": "rules.save", "summary": "保存并发布单条规则", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "rule": { "type": "object", "additionalProperties": true } }, "required": [ "version", "rule" ], "additionalProperties": true } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/rules/import": { "post": { "operationId": "rules.import", "summary": "批量发布配置规则", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/rules/test": { "post": { "operationId": "rules.test", "summary": "测试规则条件和结果", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/bml/http-connections": { "get": { "operationId": "bml.http-connections.get", "summary": "读取 BML HTTP 连接设置", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "bml.http-connections.save", "summary": "保存 BML HTTP 连接设置", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/bml/standard-functions": { "get": { "operationId": "bml.functions", "summary": "标准 BML 函数与签名", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/bml/file-download": { "get": { "operationId": "bml.file-download", "summary": "下载已保存的 BML 文件", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/bml/convert-condition": { "post": { "operationId": "bml.convert-condition", "summary": "条件表达式转换", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/bml/test": { "post": { "operationId": "bml.test", "summary": "运行 BML 测试；allowHttpWrite 可启用外部写入", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/pricing": { "get": { "operationId": "pricing.get", "summary": "定价模型与价格规则草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/pricing/preview": { "post": { "operationId": "pricing.preview", "summary": "定价试算", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center": { "get": { "operationId": "price-center.get", "summary": "读取统一价格中心草稿与版本", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/history": { "get": { "operationId": "price-center.history", "summary": "读取价格发布历史", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/approval-policy": { "get": { "operationId": "price-center.approval-policy.get", "summary": "读取价格发布审批设置与候选人", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "price-center.approval-policy.save", "summary": "保存价格审批策略并使旧申请失效", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true }, "reason": { "type": "string" } }, "required": [ "version", "data", "reason" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/approvals": { "get": { "operationId": "price-center.approvals", "summary": "分页读取价格变更审批记录", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/approval-detail": { "get": { "operationId": "price-center.approval-detail", "summary": "读取价格审批冻结差异与完整处理记录", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/approval-submit": { "post": { "operationId": "price-center.approval-submit", "summary": "提交已保存并核对的价格草稿审批", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "base": { "type": "object", "additionalProperties": true }, "reviewDigest": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "version", "base", "reviewDigest", "reason" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/approval-decide": { "post": { "operationId": "price-center.approval-decide", "summary": "按顺序批准、退回或撤回价格变更申请", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "action": { "enum": [ "approve", "reject", "withdraw" ] }, "reason": { "type": "string" } }, "required": [ "id", "version", "action" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/review": { "post": { "operationId": "price-center.review", "summary": "校验并对比待发布价格", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "base": { "type": "object", "additionalProperties": true }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "base", "data" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/draft": { "post": { "operationId": "price-center.draft", "summary": "保存统一价格草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "base": { "type": "object", "additionalProperties": true }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "base", "data" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/publish": { "post": { "operationId": "price-center.publish", "summary": "原子发布已核对的价格草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "base": { "type": "object", "additionalProperties": true }, "data": { "type": "object", "additionalProperties": true }, "reviewDigest": { "type": "string" } }, "required": [ "version", "base", "data", "reviewDigest" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/reset": { "post": { "operationId": "price-center.reset", "summary": "从当前发布版重建价格草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/restore": { "post": { "operationId": "price-center.restore", "summary": "恢复历史价格为草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "base": { "type": "object", "additionalProperties": true }, "releaseVersion": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" } }, "required": [ "version", "base", "releaseVersion" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/agreement-source-preview": { "post": { "operationId": "price-center.agreement-source-preview", "summary": "预览已批准报价可转换的协议明细，不写入", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "quoteId": { "type": "string" }, "quoteVersion": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" } }, "required": [ "quoteId" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/agreement-from-quote": { "post": { "operationId": "price-center.agreement-from-quote", "summary": "生成来源可核验的协议提案，另行保存并发布", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "quoteId": { "type": "string" }, "quoteVersion": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "lineIds": { "type": "array", "items": { "type": "string" }, "minItems": 1 } }, "required": [ "quoteId", "quoteVersion", "lineIds" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price-center/agreement-revision": { "post": { "operationId": "price-center.agreement-revision", "summary": "生成协议修订或续期提案，另行保存并发布", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "agreementId": { "type": "string" }, "agreementDigest": { "type": "string" }, "changeKind": { "enum": [ "revision", "renewal" ] }, "startDate": { "type": "string" }, "endDate": { "type": "string" } }, "required": [ "agreementId", "agreementDigest", "changeKind", "startDate" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commercial/import-preview": { "post": { "operationId": "commercial.import-preview", "summary": "价目导入预检", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commercial/preview": { "post": { "operationId": "commercial.preview", "summary": "商业价格预览", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commercial/exchange-preview": { "post": { "operationId": "commercial.exchange-preview", "summary": "币种对汇率试算", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/price": { "post": { "operationId": "price.calculate", "summary": "报价金额试算", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/settings": { "post": { "operationId": "settings.save", "summary": "保存基础价目或审批参数", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/demo": { "post": { "operationId": "demo.enable", "summary": "启用明确标记的示例价格", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commerce": { "get": { "operationId": "commerce.get", "summary": "读取商务流程草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "商务与审批" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commerce/filter-preview": { "post": { "operationId": "commerce.filter-preview", "summary": "预览商务行过滤", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "商务与审批" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commerce/constraint-preview": { "post": { "operationId": "commerce.constraint-preview", "summary": "预览商务约束", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "商务与审批" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commerce/access-preview": { "post": { "operationId": "commerce.access-preview", "summary": "预览字段与动作访问规则", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "商务与审批" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commerce/validation-preview": { "post": { "operationId": "commerce.validation-preview", "summary": "预览商务校验规则", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "商务与审批" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commerce/formula-preview": { "post": { "operationId": "commerce.formula-preview", "summary": "预览商务公式", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "商务与审批" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commerce/modify-preview": { "post": { "operationId": "commerce.modify-preview", "summary": "预览修改动作", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "商务与审批" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commerce/preview": { "post": { "operationId": "commerce.preview", "summary": "预览商务流程", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "商务与审批" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/quote-scenarios": { "get": { "operationId": "quote-scenarios.list", "summary": "销售可用报价场景", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quote-experience": { "get": { "operationId": "quote-experience.get", "summary": "报价场景、布局、字段呈现及预览参考数据", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/quote-experience/preview": { "post": { "operationId": "quote-experience.preview", "summary": "以真实报价和账号预览报价界面草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "additionalProperties": true }, "quoteId": { "type": "string" }, "userId": { "type": "string" }, "stage": { "enum": [ "draft", "pending", "approved", "rejected", "ordered" ] }, "stepId": { "type": "string" }, "scenarioId": { "type": "string" } }, "required": [ "data", "quoteId", "userId" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/quotes": { "get": { "operationId": "quotes.list", "summary": "分页查询当前账号可见报价", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" }, "post": { "operationId": "quotes.create", "summary": "从产品配置创建报价", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "modelId": { "type": "string" }, "catalogVersion": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "selection": { "type": "object", "additionalProperties": true }, "attributeValues": { "type": "object", "additionalProperties": true }, "arrayValues": { "type": "object", "additionalProperties": true }, "selectedProducts": { "type": "array", "items": { "type": "string" } }, "productQuantities": { "type": "object", "additionalProperties": true }, "configurationAction": { "type": "string" }, "currency": { "type": "string" }, "scenarioId": { "type": "string" }, "customer": { "type": "string" }, "project": { "type": "string" }, "region": { "type": "string" }, "buyerId": { "type": "string" } }, "required": [], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}": { "get": { "operationId": "quotes.get", "summary": "读取报价", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" }, "post": { "operationId": "quotes.save", "summary": "校验、重新计价并保存报价", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "customer": { "type": "string" }, "project": { "type": "string" }, "lines": { "type": "array", "items": { "type": "object", "additionalProperties": true } } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/rule-preview": { "post": { "operationId": "quotes.rule-preview", "summary": "报价未保存修改的规则预览", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/access-preview": { "post": { "operationId": "quotes.access-preview", "summary": "报价字段访问预览", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/document-preview": { "post": { "operationId": "quotes.document-preview", "summary": "报价文档预览", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "kind": { "type": "string" }, "language": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/export": { "get": { "operationId": "export.download", "summary": "导出 PDF、DOCX 或内部 BOM CSV/XLSX", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "format", "in": "query", "required": false, "schema": { "enum": [ "pdf", "docx", "csv", "xlsx" ] } }, { "name": "kind", "in": "query", "required": false, "schema": { "enum": [ "quote", "technical", "bom" ] } }, { "name": "language", "in": "query", "required": false, "schema": { "enum": [ "zh", "en", "both" ] } }, { "name": "descriptionMode", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "audience", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/jobs": { "post": { "operationId": "jobs.create", "summary": "创建异步导出或后台业务任务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/jobs/{id}": { "get": { "operationId": "jobs.get", "summary": "查询异步任务进度", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/jobs/{id}/download": { "get": { "operationId": "jobs.download", "summary": "下载后台任务产物", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/document-design": { "get": { "operationId": "document-design.get", "summary": "文档设计草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/document-design/check": { "post": { "operationId": "document-design.check", "summary": "验证文档模板", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/document-design/references": { "post": { "operationId": "document-design.references", "summary": "查询文档模板引用", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/documents/preview": { "post": { "operationId": "documents.preview", "summary": "真实报价的文档模板草稿预览", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/documents/upload": { "post": { "operationId": "documents.upload", "summary": "上传文档附件", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "filename": { "type": "string" }, "content": { "type": "string" } }, "required": [ "filename", "content" ], "additionalProperties": true } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/email-templates": { "get": { "operationId": "email-templates.get", "summary": "邮件模板草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/email-templates/preview": { "post": { "operationId": "email-templates.preview", "summary": "预览邮件模板", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/reports/manager": { "get": { "operationId": "reports.manager", "summary": "报告定义、列、文件夹和调度", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/reports/examples": { "post": { "operationId": "reports.examples", "summary": "生成可运行的报价分析示例报告", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/reports": { "get": { "operationId": "reports.query", "summary": "查询报告或导出 CSV/XLSX", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" }, "post": { "operationId": "reports.run", "summary": "按复杂条件查询报告或导出", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/reports/settings": { "post": { "operationId": "reports.settings", "summary": "保存报告权限设置", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/reports/repopulate": { "post": { "operationId": "reports.repopulate", "summary": "刷新并校验报告列", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/reports/folders": { "post": { "operationId": "reports.folders", "summary": "保存报告文件夹", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/reports/delete": { "post": { "operationId": "reports.delete", "summary": "删除报告定义", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/reports/schedules": { "post": { "operationId": "reports.schedules", "summary": "保存持久化报告调度", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/reports/email": { "post": { "operationId": "reports.email", "summary": "将报告加入邮件队列", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/reports/email-file": { "get": { "operationId": "reports.email-file", "summary": "下载报告邮件附件", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/reports/views": { "get": { "operationId": "reports.views.get", "summary": "可用报告视图", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" }, "post": { "operationId": "reports.views.save", "summary": "保存报告视图", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/logs": { "get": { "operationId": "logs.get", "summary": "分页查询运行日志", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "logs.query", "summary": "按复杂条件查询日志", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/audit": { "get": { "operationId": "audit.get", "summary": "操作审计", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "报告与审计" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/users": { "get": { "operationId": "users.get", "summary": "账号权限与版本", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "数据与系统管理" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "users.save", "summary": "维护本机账号或企业业务权限", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "users": { "type": "array", "items": { "type": "object", "additionalProperties": true } } }, "required": [ "version", "users" ], "additionalProperties": true } } } }, "tags": [ "数据与系统管理" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/product-lines": { "get": { "operationId": "product-lines.get", "summary": "产品线与版本", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "product-lines.save", "summary": "维护产品线", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "lines": { "type": "array", "items": { "type": "object", "additionalProperties": true } } }, "required": [ "version", "lines" ], "additionalProperties": true } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/table/preview": { "post": { "operationId": "table.preview", "summary": "解析 CSV/XLSX 上传内容", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "filename": { "type": "string" }, "content": { "type": "string" }, "sheet": { "type": "string" } }, "required": [ "filename", "content" ], "additionalProperties": true } } } }, "tags": [ "数据与系统管理" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/import/preview": { "post": { "operationId": "import.preview", "summary": "暂存工作簿导入预检", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "filename": { "type": "string" }, "content": { "type": "string" } }, "required": [ "filename", "content" ], "additionalProperties": true } } } }, "tags": [ "数据与系统管理" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/import/commit": { "post": { "operationId": "import.commit", "summary": "提交已暂存的工作簿导入", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" } }, "required": [ "token" ], "additionalProperties": true } } } }, "tags": [ "数据与系统管理" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/signed-punchin/certificates": { "get": { "operationId": "signed-punchin.certificates.get", "summary": "公钥和证书配置", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "signed-punchin.certificates.save", "summary": "保存公钥和证书", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/signed-punchin/template": { "post": { "operationId": "signed-punchin.template", "summary": "构建签名报文模板", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/signed-punchin/test": { "post": { "operationId": "signed-punchin.test", "summary": "验证签名传入属性", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "规则与 BML" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/connections": { "get": { "operationId": "connections.get", "summary": "外部连接定义", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "connections.save", "summary": "保存外部连接定义", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/connections/cloudcc-account": { "get": { "operationId": "connections.cloudcc.get", "summary": "CloudCC 账号脱敏配置", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "connections.cloudcc.save", "summary": "保存 CloudCC 账号配置", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/connections/cloudcc-test": { "post": { "operationId": "connections.cloudcc.test", "summary": "CloudCC 连通性测试", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/connections/tasks": { "get": { "operationId": "connections.tasks.get", "summary": "连接任务与回执", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "connections.tasks.create", "summary": "创建连接任务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/connections/send": { "post": { "operationId": "connections.send", "summary": "执行外部连接任务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/connections/receipt": { "post": { "operationId": "connections.receipt", "summary": "外部回执；需 X-CPQ-Signature", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。外部回执必须通过 X-CPQ-Signature 验签和服务端任务匹配。", "parameters": [], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "连接与集成" ], "security": [ { "ReceiptSignature": [] } ], "x-cpq-scope": "signature", "x-cpq-access": "外部回执必须通过 X-CPQ-Signature 验签和服务端任务匹配。" } }, "/api/integrations/jobs": { "get": { "operationId": "integrations.jobs", "summary": "邮件与 ERP 集成任务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/integrations/deliver": { "post": { "operationId": "integrations.deliver", "summary": "投递集成任务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/integrations/email-reply": { "post": { "operationId": "integrations.email-reply", "summary": "接收审批邮件回执", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。使用已配置的邮件网关 Bearer 凭据，或有权限的业务会话。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "连接与集成" ], "security": [ { "EmailGateway": [] }, { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "gateway", "x-cpq-access": "使用已配置的邮件网关 Bearer 凭据，或有权限的业务会话。" } }, "/api/integrations/eml": { "get": { "operationId": "integrations.eml", "summary": "下载邮件原文", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/integrations/erp": { "post": { "operationId": "integrations.erp", "summary": "建立 ERP 订单同步任务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/business/policy": { "get": { "operationId": "business.policy.get", "summary": "资产与跨线业务策略", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "资产与订单" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "business.policy.save", "summary": "维护资产业务策略", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "资产与订单" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/business/assets": { "get": { "operationId": "business.assets.list", "summary": "分页查询资产", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "资产与订单" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" }, "post": { "operationId": "business.assets.create", "summary": "建立资产台账", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "资产与订单" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/business/assets/{id}": { "get": { "operationId": "business.assets.get", "summary": "读取资产", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "资产与订单" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/business/assets/{id}/preview": { "post": { "operationId": "business.assets.preview", "summary": "续费、变更、取消预览", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "资产与订单" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/business/assets/{id}/quote": { "post": { "operationId": "business.assets.quote", "summary": "从资产变更创建报价", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "资产与订单" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/business/orders": { "get": { "operationId": "business.orders", "summary": "查询报价拆分订单", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "quoteId", "in": "query", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "资产与订单" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/portal-admin": { "get": { "operationId": "portal-admin.get", "summary": "组织与门户申请", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "portal-admin.save", "summary": "保存门户组织策略", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/portal-admin/review": { "post": { "operationId": "portal-admin.review", "summary": "审核门户申请", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/portal-admin/member": { "post": { "operationId": "portal-admin.member", "summary": "维护门户成员", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/portal/register": { "post": { "operationId": "portal.register", "summary": "申请门户账号", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "渠道与客户门户" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/portal/me": { "get": { "operationId": "portal.me", "summary": "当前门户身份和可用型号", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。获准的门户账号；组织、型号、报价、资产范围由服务端限制。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "portal", "x-cpq-access": "获准的门户账号；组织、型号、报价、资产范围由服务端限制。" } }, "/api/portal/configure": { "post": { "operationId": "portal.configure", "summary": "门户配置产品", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。获准的门户账号；组织、型号、报价、资产范围由服务端限制。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "portal", "x-cpq-access": "获准的门户账号；组织、型号、报价、资产范围由服务端限制。" } }, "/api/portal/quotes": { "get": { "operationId": "portal.quotes.list", "summary": "门户报价列表", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。获准的门户账号；组织、型号、报价、资产范围由服务端限制。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "portal", "x-cpq-access": "获准的门户账号；组织、型号、报价、资产范围由服务端限制。" }, "post": { "operationId": "portal.quotes.create", "summary": "门户创建报价；需 requestId", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。获准的门户账号；组织、型号、报价、资产范围由服务端限制。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "portal", "x-cpq-access": "获准的门户账号；组织、型号、报价、资产范围由服务端限制。" } }, "/api/portal/quotes/{id}": { "get": { "operationId": "portal.quotes.get", "summary": "读取门户报价", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。获准的门户账号；组织、型号、报价、资产范围由服务端限制。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "portal", "x-cpq-access": "获准的门户账号；组织、型号、报价、资产范围由服务端限制。" } }, "/api/portal/quotes/{id}/submit": { "post": { "operationId": "portal.quotes.submit", "summary": "门户确认报价并提交", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。获准的门户账号；组织、型号、报价、资产范围由服务端限制。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "portal", "x-cpq-access": "获准的门户账号；组织、型号、报价、资产范围由服务端限制。" } }, "/api/portal/assets": { "get": { "operationId": "portal.assets.list", "summary": "门户可见资产", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。获准的门户账号；组织、型号、报价、资产范围由服务端限制。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "portal", "x-cpq-access": "获准的门户账号；组织、型号、报价、资产范围由服务端限制。" } }, "/api/portal/assets/{id}/preview": { "post": { "operationId": "portal.assets.preview", "summary": "门户资产变更预览", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。获准的门户账号；组织、型号、报价、资产范围由服务端限制。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "portal", "x-cpq-access": "获准的门户账号；组织、型号、报价、资产范围由服务端限制。" } }, "/api/portal/assets/{id}/quote": { "post": { "operationId": "portal.assets.quote", "summary": "门户资产变更报价", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。获准的门户账号；组织、型号、报价、资产范围由服务端限制。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "渠道与客户门户" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "portal", "x-cpq-access": "获准的门户账号；组织、型号、报价、资产范围由服务端限制。" } }, "/api/ai/capabilities": { "get": { "operationId": "ai.capabilities", "summary": "当前账号可用 AI 能力", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/ai/settings": { "get": { "operationId": "ai.settings.get", "summary": "AI 连接与能力配置", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "ai.settings.save", "summary": "保存 AI 草稿", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/ai/publish": { "post": { "operationId": "ai.publish", "summary": "发布 AI 配置", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/ai/test-connection": { "post": { "operationId": "ai.test-connection", "summary": "测试已配置模型服务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/ai/documents": { "get": { "operationId": "ai.documents.list", "summary": "知识资料列表", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "ai.documents.save", "summary": "上传或维护知识资料", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/ai/runs": { "get": { "operationId": "ai.runs.list", "summary": "AI 运行记录", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" }, "post": { "operationId": "ai.runs.create", "summary": "发起 AI 任务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/ai/runs/{id}": { "get": { "operationId": "ai.runs.get", "summary": "读取 AI 运行结果", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/ai/runs/{id}/apply": { "post": { "operationId": "ai.runs.apply", "summary": "应用经过校验的价格建议", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/ai/runs/{id}/select": { "post": { "operationId": "ai.runs.select", "summary": "选择推荐产品", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/ai/runs/{id}/configuration": { "post": { "operationId": "ai.runs.configuration", "summary": "读取建议配置", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "AI 与知识" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/site": { "get": { "operationId": "site.get", "summary": "SaaS 站点类型与企业入口", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "基础与身份" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/public/templates": { "get": { "operationId": "public.templates", "summary": "SaaS 可用行业模板", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "账号与企业空间" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/public/signup-requests": { "post": { "operationId": "public.signup", "summary": "申请注册", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/public/verify-email": { "post": { "operationId": "public.verify-email", "summary": "验证注册邮箱", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/public/forgot-password": { "post": { "operationId": "public.forgot-password", "summary": "发起密码重置", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/public/reset-password": { "post": { "operationId": "public.reset-password", "summary": "完成密码重置", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/public/staff-enrollment": { "post": { "operationId": "public.staff-enrollment", "summary": "平台管理员首次设置", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/account/login": { "post": { "operationId": "account.login", "summary": "集中账号登录", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/account/session": { "get": { "operationId": "account.session", "summary": "集中账号会话", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "账号与企业空间" ], "security": [ { "AccountSession": [] }, { "AccountSessionProduction": [] } ], "x-cpq-scope": "account", "x-cpq-access": "集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。" } }, "/api/account/logout": { "post": { "operationId": "account.logout", "summary": "退出集中账号会话", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "AccountSession": [] }, { "AccountSessionProduction": [] } ], "x-cpq-scope": "account", "x-cpq-access": "集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。" } }, "/api/me/tenants": { "get": { "operationId": "me.tenants.list", "summary": "当前账号的企业空间", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "账号与企业空间" ], "security": [ { "AccountSession": [] }, { "AccountSessionProduction": [] } ], "x-cpq-scope": "account", "x-cpq-access": "集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。" }, "post": { "operationId": "me.tenants.create", "summary": "创建企业空间", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "AccountSession": [] }, { "AccountSessionProduction": [] } ], "x-cpq-scope": "account", "x-cpq-access": "集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。" } }, "/api/me/tenant-sessions": { "post": { "operationId": "me.tenant-sessions", "summary": "签发企业一次性登录票据", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "AccountSession": [] }, { "AccountSessionProduction": [] } ], "x-cpq-scope": "account", "x-cpq-access": "集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。" } }, "/api/me/invitations/accept": { "post": { "operationId": "me.invitations.accept", "summary": "接受成员邀请", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "AccountSession": [] }, { "AccountSessionProduction": [] } ], "x-cpq-scope": "account", "x-cpq-access": "集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。" } }, "/api/me/ownership/accept": { "post": { "operationId": "me.ownership.accept", "summary": "接受企业所有权", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "AccountSession": [] }, { "AccountSessionProduction": [] } ], "x-cpq-scope": "account", "x-cpq-access": "集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。" } }, "/api/me/portal-requests": { "post": { "operationId": "me.portal-requests", "summary": "申请加入客户门户", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "AccountSession": [] }, { "AccountSessionProduction": [] } ], "x-cpq-scope": "account", "x-cpq-access": "集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。" } }, "/api/me/provisioning": { "get": { "operationId": "me.provisioning", "summary": "查询企业开通进度", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。", "parameters": [ { "name": "tenantId", "in": "query", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "账号与企业空间" ], "security": [ { "AccountSession": [] }, { "AccountSessionProduction": [] } ], "x-cpq-scope": "account", "x-cpq-access": "集中账号会话；仅可访问所属企业及获准的开户、邀请、票据等能力。" } }, "/api/tenant/profile": { "get": { "operationId": "tenant.profile", "summary": "企业资料、成员与权限", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/tenant/entitlements": { "get": { "operationId": "tenant.entitlements", "summary": "企业额度与使用量", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/tenant/invitations": { "post": { "operationId": "tenant.invitations", "summary": "邀请成员", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/tenant/members": { "post": { "operationId": "tenant.members", "summary": "维护成员角色和状态", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/tenant/ownership": { "post": { "operationId": "tenant.ownership", "summary": "发起所有权转移", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/tenant/close-requests": { "post": { "operationId": "tenant.close-requests", "summary": "申请关闭企业", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/tenant/support": { "post": { "operationId": "tenant.support", "summary": "支持请求与授权", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/tenant/secrets": { "post": { "operationId": "tenant.secrets", "summary": "维护企业私有密钥", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/tenant/exports": { "post": { "operationId": "tenant.exports.create", "summary": "创建企业数据导出", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/tenant/exports/{id}/download": { "get": { "operationId": "tenant.exports.download", "summary": "下载企业数据导出", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/tenant/tickets": { "get": { "operationId": "tenant.tickets.list", "summary": "当前企业的服务工单", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "priority", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "tenantId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "includeDemo", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" }, "post": { "operationId": "tenant.tickets.create", "summary": "提交企业服务工单", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "subject": { "type": "string", "maxLength": 160 }, "message": { "type": "string", "maxLength": 6000 }, "requestId": { "type": "string", "maxLength": 100 }, "category": { "type": "string", "enum": [ "account", "configuration", "usage", "incident", "other" ] }, "priority": { "type": "string", "enum": [ "high", "normal", "low" ] }, "attachments": { "type": "array", "maxItems": 3, "items": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 160 }, "data": { "type": "string", "contentEncoding": "base64" } }, "required": [ "name", "data" ], "additionalProperties": true }, "description": "提供 name 文件名和 data 的 base64 内容；单个附件最多 2 MiB。支持 PDF、PNG、JPG、TXT、LOG、CSV；文本须为 UTF-8。" } }, "required": [ "subject", "message", "requestId" ], "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/tenant/tickets/{id}": { "get": { "operationId": "tenant.tickets.get", "summary": "读取企业工单与公开消息", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" }, "post": { "operationId": "tenant.tickets.update", "summary": "回复、确认关闭或重开企业工单", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 0, "description": "读取响应中的当前版本，首次运营档案可为 0。" }, "message": { "type": "string" }, "attachments": { "type": "array", "maxItems": 3, "items": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 160 }, "data": { "type": "string", "contentEncoding": "base64" } }, "required": [ "name", "data" ], "additionalProperties": true }, "description": "提供 name 文件名和 data 的 base64 内容；单个附件最多 2 MiB。支持 PDF、PNG、JPG、TXT、LOG、CSV；文本须为 UTF-8。" }, "state": { "type": "string", "enum": [ "open", "in_progress", "waiting_customer", "resolved", "closed" ] } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/tenant/tickets/{id}/files/{fileId}": { "get": { "operationId": "tenant.tickets.download", "summary": "下载本企业工单的公开附件", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fileId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "账号与企业空间" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "tenant", "x-cpq-access": "企业域名的成员会话；邀请、所有权、密钥、导出等另校验企业角色。" } }, "/api/platform/login": { "post": { "operationId": "platform.login", "summary": "平台管理员登录；生产环境使用 MFA", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。", "parameters": [], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [], "x-cpq-scope": "public", "x-cpq-access": "无需已有会话；登录、注册、初始化仍受凭据、部署模式与频率限制。" } }, "/api/platform/session": { "get": { "operationId": "platform.session", "summary": "平台运营会话", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/logout": { "post": { "operationId": "platform.logout", "summary": "退出平台运营", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/overview": { "get": { "operationId": "platform.overview", "summary": "平台运营概览", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/tenants": { "get": { "operationId": "platform.tenants.list", "summary": "查询企业", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/tenants/{id}": { "get": { "operationId": "platform.tenants.get", "summary": "企业详情", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/tenants/{id}/suspend": { "post": { "operationId": "platform.tenants.suspend", "summary": "停用企业", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/tenants/{id}/resume": { "post": { "operationId": "platform.tenants.resume", "summary": "恢复企业", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/tenants/{id}/entitlements": { "post": { "operationId": "platform.tenants.entitlements", "summary": "调整企业额度", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/tenants/{id}/support-requests": { "post": { "operationId": "platform.tenants.support", "summary": "发起企业支持访问申请", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/tenants/{id}/backups": { "post": { "operationId": "platform.tenants.backup", "summary": "建立企业备份任务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/tenants/{id}/business-view": { "get": { "operationId": "platform.tenants.business-view", "summary": "按支持授权读取企业业务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "grantId", "in": "query", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/provisioning/{id}/retry": { "post": { "operationId": "platform.provisioning.retry", "summary": "重试开通任务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/templates": { "get": { "operationId": "platform.templates.get", "summary": "平台行业模板", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" }, "post": { "operationId": "platform.templates.save", "summary": "维护行业模板", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/staff": { "get": { "operationId": "platform.staff.get", "summary": "平台成员权限", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" }, "post": { "operationId": "platform.staff.save", "summary": "维护平台成员", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/audit": { "get": { "operationId": "platform.audit", "summary": "平台审计", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/jobs": { "get": { "operationId": "platform.jobs", "summary": "平台后台任务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/usage": { "get": { "operationId": "platform.usage", "summary": "平台用量记录", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/overview": { "get": { "operationId": "platform.console.overview", "summary": "运营工作台、统计与待办", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "days", "in": "query", "required": false, "schema": { "type": "integer", "enum": [ 7, 30, 90 ], "default": 30 } }, { "name": "view", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "includeDemo", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "showSnoozed", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/tenants": { "get": { "operationId": "platform.console.tenants", "summary": "按状态、套餐和负责人筛选企业", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "tag", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "population", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "includeDemo", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/tenants/{id}": { "get": { "operationId": "platform.console.tenant", "summary": "企业运营档案、额度、跟进与审计", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/usage": { "get": { "operationId": "platform.console.usage", "summary": "分页查询企业有效额度与用量", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "tag", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "plan", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "population", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "includeDemo", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/jobs": { "get": { "operationId": "platform.console.jobs", "summary": "分页查询后台任务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "tenantId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "kind", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "number" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/mail": { "get": { "operationId": "platform.console.mail", "summary": "分页查询邮件投递状态", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "tenantId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "kind", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "number" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/support": { "get": { "operationId": "platform.console.support", "summary": "分页查询支持授权", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "tenantId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "kind", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "number" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/audit": { "get": { "operationId": "platform.console.audit", "summary": "按企业、操作者与时间检索审计", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "tenantId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "actor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "action", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "number" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/settings": { "get": { "operationId": "platform.console.settings", "summary": "运行状态与平台人员摘要", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/batch": { "post": { "operationId": "platform.console.batch", "summary": "批量调整企业负责人或标签", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "type": "object", "properties": { "id": { "type": "string" }, "version": { "type": "integer", "minimum": 0, "description": "读取响应中的当前版本，首次运营档案可为 0。" } }, "required": [ "id", "version" ], "additionalProperties": true } }, "reason": { "type": "string" }, "assignee": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } } }, "required": [ "items", "reason" ], "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/items/{id}": { "post": { "operationId": "platform.console.item-update", "summary": "处理运营待办、分配负责人及稍后提醒", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 0, "description": "读取响应中的当前版本，首次运营档案可为 0。" }, "state": { "type": "string", "enum": [ "open", "in_progress", "resolved" ] }, "note": { "type": "string" }, "assignee": { "type": "string" }, "snoozeUntil": { "type": "number", "minimum": 0, "description": "Unix 秒；非 0 时须在未来 30 天内。" } }, "required": [ "version", "state", "note" ], "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/tenants/{id}/profile": { "post": { "operationId": "platform.console.profile", "summary": "更新企业运营档案", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 0, "description": "读取响应中的当前版本，首次运营档案可为 0。" }, "industry": { "type": "string" }, "source": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "assignee": { "type": "string" }, "category": { "type": "string", "enum": [ "customer", "demo" ] }, "reason": { "type": "string" } }, "required": [ "version", "reason" ], "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/tenants/{id}/notes": { "post": { "operationId": "platform.console.note", "summary": "添加企业跟进记录", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "body": { "type": "string", "maxLength": 2000 }, "nextAt": { "type": "number", "minimum": 0, "description": "Unix 秒；0 表示不安排下次跟进。" } }, "required": [ "body" ], "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/jobs/{id}/retry": { "post": { "operationId": "platform.console.job-retry", "summary": "重新排队失败的后台任务", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/mail/{id}/retry": { "post": { "operationId": "platform.console.mail-retry", "summary": "重新排队失败的邮件", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/tickets": { "get": { "operationId": "platform.console.tickets.list", "summary": "平台工单队列与响应指标", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "priority", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "tenantId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "includeDemo", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" }, "post": { "operationId": "platform.console.tickets.create", "summary": "为企业创建服务工单", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "subject": { "type": "string", "maxLength": 160 }, "message": { "type": "string", "maxLength": 6000 }, "requestId": { "type": "string", "maxLength": 100 }, "category": { "type": "string", "enum": [ "account", "configuration", "usage", "incident", "other" ] }, "priority": { "type": "string", "enum": [ "high", "normal", "low" ] }, "attachments": { "type": "array", "maxItems": 3, "items": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 160 }, "data": { "type": "string", "contentEncoding": "base64" } }, "required": [ "name", "data" ], "additionalProperties": true }, "description": "提供 name 文件名和 data 的 base64 内容；单个附件最多 2 MiB。支持 PDF、PNG、JPG、TXT、LOG、CSV；文本须为 UTF-8。" }, "tenantId": { "type": "string" }, "assignee": { "type": "string" } }, "required": [ "tenantId", "subject", "message", "requestId" ], "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/tickets/{id}": { "get": { "operationId": "platform.console.tickets.get", "summary": "读取平台工单详情与消息", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" }, "post": { "operationId": "platform.console.tickets.update", "summary": "回复、分派、内部备注及工单状态调整", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 0, "description": "读取响应中的当前版本，首次运营档案可为 0。" }, "message": { "type": "string" }, "attachments": { "type": "array", "maxItems": 3, "items": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 160 }, "data": { "type": "string", "contentEncoding": "base64" } }, "required": [ "name", "data" ], "additionalProperties": true }, "description": "提供 name 文件名和 data 的 base64 内容；单个附件最多 2 MiB。支持 PDF、PNG、JPG、TXT、LOG、CSV；文本须为 UTF-8。" }, "state": { "type": "string", "enum": [ "open", "in_progress", "waiting_customer", "resolved", "closed" ] }, "assignee": { "type": "string" }, "priority": { "type": "string", "enum": [ "high", "normal", "low" ] }, "visibility": { "type": "string", "enum": [ "public", "internal" ] } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/tickets/{id}/files/{fileId}": { "get": { "operationId": "platform.console.tickets.download", "summary": "下载获准工单附件", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "fileId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/plans": { "get": { "operationId": "platform.console.plans.get", "summary": "套餐版本与预约调整记录", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" }, "post": { "operationId": "platform.console.plans.publish", "summary": "发布新套餐额度版本", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plan": { "type": "string" }, "version": { "type": "integer", "minimum": 0, "description": "读取响应中的当前版本，首次运营档案可为 0。" }, "limits": { "type": "object", "additionalProperties": true }, "reason": { "type": "string" } }, "required": [ "plan", "version", "limits", "reason" ], "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/schedules/{id}/cancel": { "post": { "operationId": "platform.console.schedule-cancel", "summary": "取消尚未执行的套餐调整预约", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/template-preflight": { "post": { "operationId": "platform.console.template-preflight", "summary": "模板导入只读预检与差异", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "text": { "type": "string" }, "content": { "type": "object", "additionalProperties": true } }, "required": [], "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/templates/{id}/history": { "get": { "operationId": "platform.console.template-history", "summary": "行业模板历史版本与差异", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, { "name": "version", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "compare", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "对比的历史版本；默认选择所选版本的上一版，最低为 1。" } } ], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/platform/console/templates/{id}/trial": { "post": { "operationId": "platform.console.template-trial", "summary": "将指定模板版本试开通为独立演示企业", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 0, "description": "读取响应中的当前版本，首次运营档案可为 0。" }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "version", "requestId", "reason" ], "additionalProperties": true } } } }, "tags": [ "平台运营" ], "security": [ { "PlatformSession": [] }, { "PlatformSessionProduction": [] } ], "x-cpq-scope": "platform", "x-cpq-access": "平台运营会话；各操作另校验 admin、ops、support、billing、auditor 等角色。企业域名不提供平台 API。" } }, "/api/catalog/draft": { "post": { "operationId": "catalog.draft", "summary": "保存草稿：catalog", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "catalog": { "type": "object", "additionalProperties": true } }, "required": [ "version", "catalog" ], "additionalProperties": true } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/catalog/publish": { "post": { "operationId": "catalog.publish", "summary": "发布定义：catalog", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "catalog": { "type": "object", "additionalProperties": true } }, "required": [ "version", "catalog" ], "additionalProperties": true } } } }, "tags": [ "产品与配置" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/pricing/draft": { "post": { "operationId": "pricing.draft", "summary": "保存草稿：pricing", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/pricing/publish": { "post": { "operationId": "pricing.publish", "summary": "发布定义：pricing", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commerce/draft": { "post": { "operationId": "commerce.draft", "summary": "保存草稿：commerce", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "商务与审批" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/commerce/publish": { "post": { "operationId": "commerce.publish", "summary": "发布定义：commerce", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "商务与审批" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/document-design/draft": { "post": { "operationId": "document-design.draft", "summary": "保存草稿：document-design", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/document-design/publish": { "post": { "operationId": "document-design.publish", "summary": "发布定义：document-design", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/email-templates/draft": { "post": { "operationId": "email-templates.draft", "summary": "保存草稿：email-templates", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/email-templates/publish": { "post": { "operationId": "email-templates.publish", "summary": "发布定义：email-templates", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "文档与导出" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/quote-experience/draft": { "post": { "operationId": "quote-experience.draft", "summary": "保存草稿：quote-experience", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/quote-experience/publish": { "post": { "operationId": "quote-experience.publish", "summary": "发布定义：quote-experience", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/manage/commercial": { "get": { "operationId": "manage.commercial.get", "summary": "读取commercial", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "manage.commercial.save", "summary": "保存commercial", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "价格与协议" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/manage/approvalPolicy": { "get": { "operationId": "manage.approvalPolicy.get", "summary": "读取approvalPolicy", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "商务与审批" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "manage.approvalPolicy.save", "summary": "保存approvalPolicy", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "商务与审批" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/manage/publishing": { "get": { "operationId": "manage.publishing.get", "summary": "读取publishing", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "数据与系统管理" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "manage.publishing.save", "summary": "保存publishing", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "数据与系统管理" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/manage/integrations": { "get": { "operationId": "manage.integrations.get", "summary": "读取integrations", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [], "x-cpq-readOnly": true, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" }, "post": { "operationId": "manage.integrations.save", "summary": "保存integrations", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务管理员入口；继续执行版本、产品线及领域校验。", "parameters": [ { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "data": { "type": "object", "additionalProperties": true } }, "required": [ "version", "data" ], "additionalProperties": true } } } }, "tags": [ "连接与集成" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "admin", "x-cpq-access": "业务管理员入口；继续执行版本、产品线及领域校验。" } }, "/api/quotes/{id}/clone": { "post": { "operationId": "quotes.clone", "summary": "报价动作 clone；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/adopt-process": { "post": { "operationId": "quotes.adopt-process", "summary": "报价动作 adopt-process；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/modify": { "post": { "operationId": "quotes.modify", "summary": "报价动作 modify；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/advance": { "post": { "operationId": "quotes.advance", "summary": "报价动作 advance；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/remind": { "post": { "operationId": "quotes.remind", "summary": "报价动作 remind；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/reprice": { "post": { "operationId": "quotes.reprice", "summary": "报价动作 reprice；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/reconfigure": { "post": { "operationId": "quotes.reconfigure", "summary": "报价动作 reconfigure；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/submit": { "post": { "operationId": "quotes.submit", "summary": "报价动作 submit；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/approve": { "post": { "operationId": "quotes.approve", "summary": "报价动作 approve；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/reject": { "post": { "operationId": "quotes.reject", "summary": "报价动作 reject；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/withdraw": { "post": { "operationId": "quotes.withdraw", "summary": "报价动作 withdraw；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/order": { "post": { "operationId": "quotes.order", "summary": "报价动作 order；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/add-configuration": { "post": { "operationId": "quotes.add-configuration", "summary": "报价动作 add-configuration；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/copy-configuration": { "post": { "operationId": "quotes.copy-configuration", "summary": "报价动作 copy-configuration；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/remove-configuration": { "post": { "operationId": "quotes.remove-configuration", "summary": "报价动作 remove-configuration；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/rename-configuration": { "post": { "operationId": "quotes.rename-configuration", "summary": "报价动作 rename-configuration；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } }, "/api/quotes/{id}/reorder-configurations": { "post": { "operationId": "quotes.reorder-configurations", "summary": "报价动作 reorder-configurations；必须携带最新 version", "description": "复用服务端业务校验；未逐字段列出的 body/query 为开放对象。权限由当前登录账号决定。保存/发布需最新版本；HTTP 400 也可能表示业务版本冲突。写请求不自动重试。业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-CPQ-CSRF", "in": "header", "required": false, "schema": { "type": "string" }, "description": "SaaS 会话写请求必需，从会话读取接口取得；CLI/MCP 自动携带。网关凭据回执不适用。" } ], "x-cpq-readOnly": false, "responses": { "400": { "description": "输入、业务校验或版本冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "会话失效", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "无权限", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "并发冲突", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "额度或限流", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "对象、域名范围或接口不存在" }, "500": { "description": "服务端处理失败" }, "503": { "description": "服务暂时不可用" }, "200": { "description": "原始业务 JSON（对象或数组）或文件，不包含 CLI 的 ok/status/data 包装。", "content": { "application/json": { "schema": {} }, "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "integer", "minimum": 1, "description": "最近一次读取或保存返回的版本；不要自行递增。" }, "comment": { "type": "string" } }, "required": [ "version" ], "additionalProperties": true } } } }, "tags": [ "报价与界面" ], "security": [ { "BusinessSession": [] }, { "BusinessSessionProduction": [] } ], "x-cpq-scope": "business", "x-cpq-access": "业务账号；继续执行产品线、报价所有权、审批、金额及字段权限。" } } } }