API访问

概述

VisioArt 可以为自动化、内部工具或生产集成暴露 API 工作流，但 API 访问是否可用取决于当前部署。有些环境会在仪表盘中开放自助 API 密钥，有些环境则默认关闭，或仅通过人工方式开通。

查找 API 密钥

如果您的账户已启用 API 访问，请在 VisioArt 仪表盘中进入 设置 → API密钥。该页面会列出当前有效的密钥、创建时间戳，以及部署选择展示的相关元数据。

如果看不到 API密钥 选项卡，说明当前部署或当前账户层级尚未开放自助 API 访问。

生成新密钥

当功能开启时：

• 点击 创建API密钥
• 添加描述性标签，例如 CI流水线 或 移动端后端
• 立即复制密钥，因为完整密钥通常只会展示一次
• 将其存放到安全的环境变量或密钥管理器中

撤销密钥

撤销密钥会立即生效。之后任何使用该密钥签名的请求都会被拒绝。如果怀疑密钥泄露，应立即轮换。

权限

具体权限模型取决于部署配置。有些环境提供简单的读写范围，有些环境则会把密钥限制到特定动作或内部工作流。对每个集成都应使用当前可用的最小权限范围。

速率限制与并发

速率限制和并发任务额度并不是所有 VisioArt 部署都统一的，应视为环境相关参数。客户端应当：

• 正确处理 429 Too Many Requests
• 实现带退避的重试策略
• 不要假设不同账户或工作区拥有相同并发额度

当 API 不可用时

如果当前工作区没有开放自助 API 密钥，请使用 Web 仪表盘完成工作流，或在确实需要编程访问时与部署管理员协调开通。