Devin API を使うと、Devin をアプリケーションに統合し、ワークフローを自動化し、強力なツールを構築できます。用途や認証モデルの違いに合わせて設計された 3 種類の API バージョンを提供しています。
Devinは、機能と認証要件が異なる3つのAPIバージョンを提供します。
v1 API は、組織スコープのアクセスでセッション管理のコア機能を提供します。
ベース URL： https://api.devin.ai/v1/*
認証方式： Personal または Service API Keys
主な機能：
- Devin セッションの作成と管理
- アクティブなセッションへのメッセージ送信
- シークレット、Knowledge、プレイブックの管理
- 添付ファイルのアップロードとダウンロード
- セッションタグの更新
主なユースケース：
- 一般的なセッションの自動化
- エンドユーザー向け連携
- CI/CD パイプライン
- 開発およびテスト
v1 API ドキュメントを表示 →
Enterprise API v2（Enterprise 管理者のみ）
https://api.devin.ai/v2/enterprise/*
認証： Enterprise 管理者の個人用 APIキー のみ
主な機能:
- Enterprise 全体のセッション分析とインサイト
- 組織およびメンバー管理
- 利用状況のトラッキングと課金データ
- 監査ログおよびコンプライアンスレポート
- Git 権限管理
- リポジトリのインデックス作成
適している用途:
- Enterprise 管理者
- 分析およびレポート作成
- コンプライアンスおよび監査
- 組織管理
Enterprise API v2 ドキュメントを見る →
v3 API は、サービスユーザー認証により完全な RBAC サポートを提供します。
ベース URL:
https://api.devin.ai/v3beta1/enterprise/*https://api.devin.ai/v3beta1/organizations/*
認証方式: サービスユーザー認証情報（Enterprise または Organization レベル）
主な特徴:
- 完全なロールベースアクセス制御（RBAC）
- 専用ロールを持つサービスユーザー
- きめ細かな権限設定
- 複数組織にまたがるワークフロー
- 人間アカウントとサービスアカウントの明確な分離
適したユースケース:
- 特定の権限を持つ本番環境での自動化
- 複数組織間の連携
- コンプライアンス要件の厳しいワークフロー
- 長期間稼働するサービス連携
v3 API ドキュメントを見る →
- v1 API の場合： 任意のサブ組織の Settings > API Keys から APIキーを発行します
- v2 API の場合： 任意のサブ組織の Settings > API Keys から個人用の APIキーを発行します
- v3 API の場合： Enterprise Settings > Service Users からサービスユーザーを作成します
APIキーは安全に保管し、GitHub リポジトリやクライアントサイドのコードなど、一般に公開される場所で共有しないでください。
Authorization ヘッダーに APIキー を含めてください：
Authorization: Bearer your_api_key_here
curl -X POST "https://api.devin.ai/v1/sessions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Hello Worldを出力するシンプルなPythonスクリプトを作成してください"
}'
すべての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: サーバー内部エラー
API に関するご質問や不具合のご報告は、[email protected] までご連絡ください。
