Skip to main content
Devin API 允许你将 Devin 集成到你的应用程序中、实现工作流自动化，并构建强大的工具。使用 service users (服务用户) 配合基于角色的访问控制，实现安全且可审计的 API 访问。

​
入门

Teams 快速入门

适用于团队和标准组织。创建服务用户，在几分钟内完成首次 API 调用。

Enterprise 快速入门

适用于使用 RBAC、多组织支持和高级权限的 Enterprise 客户。
我应该选择哪种方式？ 大多数客户应从 Teams 快速入门开始。如果你管理多个组织、使用 SSO (单点登录) ，或需要自定义角色和 RBAC，请选择 Enterprise。

​
API 结构

API 分为两个作用域：

​
Organization API

基础 URL： https://api.devin.ai/v3/organizations/* 用于管理单个组织内的资源，如 sessions、Knowledge、playbooks、secrets 等。大多数集成都从这里开始。

​
Enterprise API

基本 URL： https://api.devin.ai/v3/enterprise/* 用于跨组织管理，包括分析、审计日志、用户管理、计费和基础设施。仅向企业客户提供。 这两个 scope 都使用服务用户凭据 (cog_ 前缀) 。有关配置，请参见 Authentication。

​
会话归因

服务用户与人类用户是不同的身份，但你可以使用 create_as_user_id 参数代表组织中的任何用户创建会话。这意味着这些会话会出现在该用户的会话列表中，并计入该用户的使用量——就像由他们自己创建的一样。
从个人 API key 迁移过来？ 在 v1/v2 中，个人 API key 会自动以你的用户身份创建会话。使用 v3 时，改用服务用户 (service user) 加上 create_as_user_id 即可实现相同行为——并额外获得 RBAC、审计日志以及集中化密钥管理等优势。服务用户的角色必须包含 ImpersonateOrgSessions 权限。
你还可以使用 Personal Access Token 直接以自己的用户身份进行认证——不再需要服务用户或 create_as_user_id。会话会自动归属到你名下。
你可以通过 List organization users 端点 (beta，需使用组织作用域的服务用户) 或企业级 List users 端点查找用户 ID。这两个端点都只返回直接分配了角色的用户。如果用户是通过 IDP 组获得成员身份的，请使用 List organization IDP group users 或对应的企业级端点。

​
旧版 API (v1 和 v2)

在弃用过渡期间，v1 和 v2 API 将继续可用，但不会再获得新功能。我们建议迁移到当前版本的 API，以获得基于角色的访问控制、会话归因以及新的功能能力。

​
错误处理

所有 API 均使用标准 HTTP 状态码：
  • 200 OK: 请求成功
  • 201 Created: 资源创建成功
  • 400 Bad Request: 请求参数无效
  • 401 Unauthorized: 缺少或无效的 API key
  • 403 Forbidden: 权限不足
  • 404 Not Found: 未找到资源
  • 429 Too Many Requests: 超出请求频率限制
  • 500 Internal Server Error: 服务器内部错误

​
支持

如有关于 API 的疑问或需要报告问题，请发送电子邮件至 support@cognition.ai。