> ## 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.

# API 概要

> REST API を使ってプログラムから Devin と対話する方法を学ぶ

Devin API を使うと、Devin をアプリケーションに統合し、ワークフローを自動化し、強力なツールを構築できます。安全で監査可能な API アクセスを実現するには、ロールベースのアクセス制御を備えた **サービスユーザー** を使用してください。

<div id="getting-started">
  ## はじめに
</div>

<CardGroup cols={2}>
  <Card title="Teams クイックスタート" icon="rocket" href="/ja/api-reference/getting-started/teams-quickstart">
    チームおよび通常の組織向けです。サービスユーザーを作成し、数分で最初の API 呼び出しを実行できます。
  </Card>

  <Card title="Enterprise クイックスタート" icon="building" href="/ja/api-reference/getting-started/enterprise-quickstart">
    RBAC、複数組織対応、高度な権限管理を必要とする Enterprise プランのお客様向けです。
  </Card>
</CardGroup>

<Tip>
  **どちらの方法を選べばよいですか？** ほとんどのお客様には Teams クイックスタートから始めることを推奨します。複数の組織を管理している場合、SSO (シングルサインオン) を利用している場合、またはカスタムロールや RBAC が必要な場合は Enterprise を選択してください。
</Tip>

<div id="api-structure">
  ## API 構造
</div>

API は 2 つのスコープに分かれています。

<div id="organization-api">
  ### 組織 API
</div>

**ベース URL:** `https://api.devin.ai/v3/organizations/*`

1 つの組織内のリソース (セッション、Knowledge、プレイブック、シークレットなど) を管理するための API です。ほとんどのインテグレーションはここから始まります。

<div id="enterprise-api">
  ### Enterprise API
</div>

**ベースURL：** `https://api.devin.ai/v3/enterprise/*`

組織横断の管理 (分析、監査ログ、ユーザー管理、請求、インフラストラクチャ) のための API です。Enterprise プランのお客様向けに提供されています。

両方のスコープでサービスユーザーの認証情報 (`cog_` プレフィックス) を使用します。セットアップ方法は [Authentication](/ja/api-reference/authentication) を参照してください。

<div id="session-attribution">
  ## セッションの帰属
</div>

Service user は人間のユーザーとは別のアイデンティティですが、組織内の任意のユーザーに代わって `create_as_user_id` パラメータを使って**セッションを作成できます**。これにより、そのセッションはそのユーザーのセッション一覧に表示され、そのユーザーの使用量としてカウントされます。つまり、そのユーザー自身が作成したセッションとして扱われます。

```bash theme={null}
curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Fix the login bug in issue #42",
    "create_as_user_id": "user_abc123"
  }'
```

<Tip>
  **個人用 API キーから移行しますか？** v1/v2 では、個人用 API キーは自分のユーザーとして自動的にセッションを作成していました。v3 では、同じ動作を実現するにはサービスユーザーと `create_as_user_id` を使用します — さらに RBAC、監査ログ、キーの一元管理といった利点も得られます。サービスユーザーのロールには `ImpersonateOrgSessions` 権限が含まれている必要があります。
</Tip>

<Note>
  **Personal Access Tokens (PATs) は近日提供予定です。** PATs を使うと、サービスユーザーや `create_as_user_id` を使用せずに、v3 API で自分のユーザーとして直接認証できるようになります。セッションは自動的にあなたに紐づけられます。提供開始の続報をお待ちください。
</Note>

ユーザー ID は、[List users](/ja/api-reference/v3/users/organizations-members-users) エンドポイント、または Devin の UI の組織メンバー設定から確認できます。

<div id="legacy-apis-v1-and-v2">
  ## レガシー API (v1 と v2)
</div>

v1 および v2 API は非推奨期間中も引き続き動作しますが、新機能は追加されません。ロールベースのアクセス制御やセッションアトリビューション、新機能を利用するには、現在の API への移行を推奨します。

* [v1 API documentation](/ja/api-reference/v1/overview) — レガシー API キーを用いたセッション管理
* [v2 API documentation](/ja/api-reference/v2/overview) — レガシー API キーを用いた Enterprise 管理
* [Migration guide](/ja/api-reference/getting-started/migration-guide) — v1/v2 からの段階的な移行手順

***

<div id="error-handling">
  ## エラー処理
</div>

すべてのAPIは標準的なHTTPステータスコードを使用します:

* `200 OK`: リクエストの成功
* `201 Created`: リソースの正常な作成
* `400 Bad Request`: 無効なリクエストパラメータ
* `401 Unauthorized`: APIキーが存在しないか無効
* `403 Forbidden`: 権限不足
* `404 Not Found`: リソースが見つからない
* `429 Too Many Requests`: レート制限の超過
* `500 Internal Server Error`: サーバー内部エラー

<div id="support">
  ## サポート
</div>

API に関するご質問や不具合のご報告は、[support@cognition.ai](mailto:support@cognition.ai) までご連絡ください。