# API 访问状态 账户 API 密钥控制、正式合作伙伴集成与 Aiviance 内部路由之间的当前边界。 Aiviance 目前没有发布通用的公开 API 参考。本页面记录这一边界,避免把产品内部路由误认为受支持的外部契约。 ## API 密钥是受控凭证 在相应能力已启用时,登录后的产品可以为账户签发、列出和撤销 API 密钥。密钥内容只在签发时显示;存储的密钥经过哈希处理,归属于明确的所有者,并留下审计记录。不活跃满 90 天的密钥会被自动撤销。 持有 API 密钥并不代表所有 Aiviance 路由都成为公开接口。密钥只能用于 Aiviance 已明确向该账户或合作伙伴提供文档的接口。 ## 内部路由不是 API 参考 Aiviance Web、移动端、顾问端与运行服务使用的 `/api/v1` 路由是应用适配器。除非某条路由出现在已批准的开发者契约中,否则其路径、请求体和响应结构都可能随产品变化。 请勿通过发现或复制浏览器请求来构建集成。内部定时任务路由、回调、webhook 和管理路由同样不属于通用公开接口。 ## 正式公开契约必须包含什么 受支持的外部 API 会说明基础 URL、认证、权限范围、实体所有权规则、版本、速率限制、错误格式、幂等要求和弃用政策。如果某个接口没有提供这些信息,应将其视为不可供外部使用。 如需申请受支持的集成,请向 Aiviance 提供使用场景、数据范围、预计流量和安全模型。另请阅读[开发者平台边界](/docs/developers/platform-boundary)与[集成生命周期](/docs/developers/integrations)。