> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# v2 API 概览（旧版）

> 面向管理员的企业级管理、分析和合规能力

<Warning>
  此 API 版本已弃用。请使用采用服务用户身份验证的 [API v3](/zh/api-reference/v3/overview)。请参阅[迁移指南](/zh/api-reference/getting-started/migration-guide)获取分步操作说明。
</Warning>

v2 API 为企业范围内的 Enterprise Admin 提供管理、分析和合规能力。

<Note>
  访问 v2 API 需要 Enterprise Admin 角色。
</Note>

**Base URL:** `https://api.devin.ai/v2/enterprise/*`

**Authentication:** Enterprise Admin 个人 API 密钥 ([了解更多](/zh/api-reference/authentication))

<div id="permissions">
  ## 权限
</div>

使用 v2 API 需要 **Enterprise Admin** 角色。只有拥有此角色的用户才能生成可用于 v2 端点的个人 API key。不支持服务 API key 和组织级别的 API key。

所有 v2 端点都提供对 Enterprise 中所有组织资源的企业级访问权限。若需要按组织范围的访问或更细粒度的 RBAC 控制，请分别使用 [Organization API](/zh/api-reference/v3/overview) 或 [Enterprise API](/zh/api-reference/v3/overview)。

<div id="api-keys">
  ## API key
</div>

为你的企业创建和管理服务 API key：

<CardGroup cols={2}>
  <Card title="签发服务 API key" icon="key" href="/zh/api-reference/v2/api-keys/provision-service-key">
    为自动化创建新的服务 API key
  </Card>

  <Card title="列出 API key" icon="list" href="/zh/api-reference/v2/api-keys/list-enterprise-api-keys">
    查看企业中的所有 API key
  </Card>

  <Card title="撤销 API key" icon="ban" href="/zh/api-reference/v2/api-keys/revoke-enterprise-api-key">
    撤销指定的 API key
  </Card>
</CardGroup>

<div id="audit-logs">
  ## 审计日志
</div>

访问合规与安全审计日志：

<CardGroup cols={2}>
  <Card title="获取审计日志" icon="scroll" href="/zh/api-reference/v2/audit-logs">
    获取企业级范围内的审计日志以满足合规需求
  </Card>
</CardGroup>

<div id="consumption">
  ## 用量
</div>

跟踪 ACU 用量和计费：

<CardGroup cols={2}>
  <Card title="用量周期" icon="chart-pie" href="/zh/api-reference/v2/consumption/consumption-cycles">
    查看用量周期汇总
  </Card>

  <Card title="每日用量" icon="calendar-day" href="/zh/api-reference/v2/consumption/daily-consumption">
    获取每日用量明细
  </Card>

  <Card title="用户每日用量" icon="user" href="/zh/api-reference/v2/consumption/user-daily-consumption">
    按用户跟踪用量
  </Card>
</CardGroup>

<div id="groups">
  ## 组
</div>

管理企业 IdP 组：

<CardGroup cols={2}>
  <Card title="列出组" icon="users" href="/zh/api-reference/v2/groups/list-enterprise-groups">
    查看企业内所有 IdP 组
  </Card>

  <Card title="获取组详情" icon="circle-info" href="/zh/api-reference/v2/groups/get-group-details">
    获取指定组的详细信息
  </Card>
</CardGroup>

<div id="members">
  ## 成员
</div>

管理 Enterprise 成员和角色：

<CardGroup cols={2}>
  <Card title="成员列表" icon="users" href="/zh/api-reference/v2/members/list-enterprise-members">
    查看企业中的所有成员
  </Card>

  <Card title="获取成员详情" icon="circle-info" href="/zh/api-reference/v2/members/get-member-details">
    获取指定成员的详细信息
  </Card>

  <Card title="邀请成员" icon="envelope" href="/zh/api-reference/v2/members/invite-enterprise-members">
    邀请新成员加入企业
  </Card>

  <Card title="删除成员" icon="trash" href="/zh/api-reference/v2/members/delete-enterprise-member">
    从企业中移除成员
  </Card>

  <Card title="角色列表" icon="shield" href="/zh/api-reference/v2/members/list-roles">
    查看可用角色
  </Card>
</CardGroup>

<div id="metrics">
  ## 指标
</div>

访问分析和使用指标：

<CardGroup cols={2}>
  <Card title="PR 指标" icon="code-pull-request" href="/zh/api-reference/v2/consumption/pr-metrics">
    查看 pull request (PR) 指标
  </Card>

  <Card title="会话指标" icon="chart-line" href="/zh/api-reference/v2/consumption/sessions-metrics">
    查看会话分析
  </Card>

  <Card title="搜索指标" icon="magnifying-glass-chart" href="/zh/api-reference/v2/consumption/searches-metrics">
    查看搜索使用指标
  </Card>

  <Card title="使用情况指标" icon="gauge-high" href="/zh/api-reference/v2/consumption/usage-metrics">
    获取总体使用情况分析
  </Card>
</CardGroup>

<div id="organizations">
  ## 组织
</div>

管理子组织：

<CardGroup cols={2}>
  <Card title="组织列表" icon="building" href="/zh/api-reference/v2/organizations/list-organizations">
    查看 Enterprise 帐户下的所有组织
  </Card>

  <Card title="创建组织" icon="plus" href="/zh/api-reference/v2/organizations/create-organization">
    创建新的子组织
  </Card>

  <Card title="获取组织" icon="circle-info" href="/zh/api-reference/v2/organizations/get-organization-details">
    获取组织详情
  </Card>

  <Card title="更新组织" icon="pencil" href="/zh/api-reference/v2/organizations/update-organization">
    更新组织设置
  </Card>

  <Card title="删除组织" icon="trash" href="/zh/api-reference/v2/organizations/delete-organization">
    删除子组织
  </Card>
</CardGroup>

<div id="sessions">
  ## 会话
</div>

查看企业范围内的会话数据：

<CardGroup cols={2}>
  <Card title="列出会话" icon="list" href="/zh/api-reference/v2/sessions/list-enterprise-sessions">
    查看整个企业的所有会话
  </Card>

  <Card title="会话洞察" icon="lightbulb" href="/zh/api-reference/v2/sessions/list-enterprise-sessions-insights">
    获取 AI 驱动的会话洞察
  </Card>

  <Card title="获取会话" icon="circle-info" href="/zh/api-reference/v2/sessions/get-enterprise-session">
    获取特定会话的详细信息
  </Card>
</CardGroup>

<div id="playbooks">
  ## playbooks
</div>

管理企业级的 playbooks：

<CardGroup cols={2}>
  <Card title="列出 playbooks" icon="book" href="/zh/api-reference/v2/playbooks/list-playbooks">
    查看所有 playbooks
  </Card>

  <Card title="创建 playbooks" icon="plus" href="/zh/api-reference/v2/playbooks/create-playbook">
    创建新的 playbooks
  </Card>
</CardGroup>

<div id="next-steps">
  ## 后续步骤
</div>

迁移到[当前 API](/zh/api-reference/overview)，以获得基于服务用户的 RBAC 支持、会话归因能力以及其他新功能。请参阅[迁移指南](/zh/api-reference/getting-started/migration-guide)。