メインコンテンツへスキップ
このページでは、Service User API v3 の代表的なユースケース向けのコード例を紹介します。

簡単なサンプル

import os
import requests

TOKEN = os.getenv("DEVIN_SERVICE_USER_TOKEN")
BASE_URL = "https://api.devin.ai/v3beta1"

response = requests.get(
    f"{BASE_URL}/enterprise/self",
    headers={"Authorization": f"Bearer {TOKEN}"}
)

self_info = response.json()
print(f"Service User: {self_info['name']}")
print(f"Role: {self_info['role']}")
import os
import requests

TOKEN = os.getenv("DEVIN_SERVICE_USER_TOKEN")
BASE_URL = "https://api.devin.ai/v3beta1"

response = requests.get(
    f"{BASE_URL}/enterprise/organizations",
    headers={"Authorization": f"Bearer {TOKEN}"}
)

orgs = response.json()
for org in orgs["organizations"]:
    print(f"{org['name']} ({org['id']})")
import os
import requests

TOKEN = os.getenv("DEVIN_SERVICE_USER_TOKEN")
BASE_URL = "https://api.devin.ai/v3beta1"

response = requests.post(
    f"{BASE_URL}/enterprise/organizations",
    headers={
        "Authorization": f"Bearer {TOKEN}",
        "Content-Type": "application/json"
    },
    json={
        "name": "データサイエンスチーム",
        "acu_limit": 500
    }
)

org = response.json()
print(f"組織を作成しました: {org['id']}")
import os
import requests

TOKEN = os.getenv("DEVIN_SERVICE_USER_TOKEN")
BASE_URL = "https://api.devin.ai/v3beta1"
org_id = "your_org_id"

response = requests.post(
    f"{BASE_URL}/organizations/{org_id}/sessions",
    headers={
        "Authorization": f"Bearer {TOKEN}",
        "Content-Type": "application/json"
    },
    json={
        "prompt": "CSVデータを分析するPythonスクリプトを作成する"
    }
)

session = response.json()
print(f"Session created: {session['session_id']}")
print(f"URL: {session['url']}")
import os
import requests

TOKEN = os.getenv("DEVIN_SERVICE_USER_TOKEN")
BASE_URL = "https://api.devin.ai/v3beta1"

response = requests.get(
    f"{BASE_URL}/enterprise/consumption/daily/organizations",
    headers={"Authorization": f"Bearer {TOKEN}"},
    params={"start_date": "2024-01-01", "end_date": "2024-01-31"}
)

consumption = response.json()
for entry in consumption["data"]:
    print(f"{entry['organization_name']}: {entry['acus_used']} ACUs")
import os
import requests

TOKEN = os.getenv("DEVIN_SERVICE_USER_TOKEN")
BASE_URL = "https://api.devin.ai/v3beta1"
org_id = "your_org_id"

response = requests.post(
    f"{BASE_URL}/organizations/{org_id}/members/service-users",
    headers={
        "Authorization": f"Bearer {TOKEN}",
        "Content-Type": "application/json"
    },
    json={
        "name": "CI/CD Bot",
        "role": "developer"
    }
)

service_user = response.json()
print(f"Created service user: {service_user['id']}")
print(f"APIキー: {service_user['api_key']}")  # 一度だけ表示されます!
import os
import requests
from datetime import datetime, timedelta, timezone

TOKEN = os.getenv("DEVIN_SERVICE_USER_TOKEN")
BASE_URL = "https://api.devin.ai/v3beta1"

# UTC での過去 7 日間を Unix タイムスタンプ(秒)として取得
now = datetime.now(timezone.utc)
seven_days_ago = now - timedelta(days=7)

params = {
    "time_after": int(seven_days_ago.timestamp()),
    "time_before": int(now.timestamp()),
    "first": 100,  # ページサイズ(最大 200)
}

response = requests.get(
    f"{BASE_URL}/enterprise/audit-logs",
    headers={"Authorization": f"Bearer {TOKEN}"},
    params=params,
)
response.raise_for_status()

data = response.json()

for log in data["items"]:
    ts = datetime.fromtimestamp(log["created_at"], tz=timezone.utc).isoformat()
    actor_id = log.get("service_user_id") or log.get("user_id") or "system"
    print(f"{ts} - {log['action']} (org={log.get('org_id')}, actor={actor_id})")

# 追加ページを取得するには、has_next_page が True の場合に end_cursor を使用します:
# if data["has_next_page"]:
#     params["after"] = data["end_cursor"]
#     # 更新されたパラメータで再度リクエストを実行
複数の組織にまたがる自動化:
import os
import requests

TOKEN = os.getenv("DEVIN_SERVICE_USER_TOKEN")
BASE_URL = "https://api.devin.ai/v3beta1"

# すべての組織を取得
orgs_response = requests.get(
    f"{BASE_URL}/enterprise/organizations",
    headers={"Authorization": f"Bearer {TOKEN}"}
)
organizations = orgs_response.json()["organizations"]

# 各組織でセッションを作成
for org in organizations:
    session_response = requests.post(
        f"{BASE_URL}/organizations/{org['id']}/sessions",
        headers={
            "Authorization": f"Bearer {TOKEN}",
            "Content-Type": "application/json"
        },
        json={
            "prompt": f"Run daily health check for {org['name']}"
        }
    )
    
    if session_response.ok:
        session = session_response.json()
        print(f"Created session for {org['name']}: {session['session_id']}")
    else:
        print(f"Failed to create session for {org['name']}")
import os
import requests

TOKEN = os.getenv("DEVIN_SERVICE_USER_TOKEN")
BASE_URL = "https://api.devin.ai/v3beta1"

try:
    response = requests.get(
        f"{BASE_URL}/enterprise/organizations",
        headers={"Authorization": f"Bearer {TOKEN}"}
    )
    response.raise_for_status()
    data = response.json()
except requests.exceptions.HTTPError as e:
    if e.response.status_code == 401:
        print("サービスユーザートークンが無効または期限切れです")
    elif e.response.status_code == 403:
        print("サービスユーザーに必要なロール/権限がありません")
    elif e.response.status_code == 429:
        print("レート制限を超過しました。待機して再試行してください")
    else:
        print(f"APIエラー: {e}")

サポート

お困りですか?

API に関するご質問や不具合のご報告は、[email protected] までメールでご連絡ください。