AI コード指標 & 追跡

このドキュメントについて

AI コード指標（集計統計）と AI コード追跡（詳細および CSV エクスポート）。セクションによりページネーション方式が異なります。事前に API キーの取得 を完了し、共通仕様 を参照してください。

前提条件

組織に紐づく有効な API キー（Authorization: Bearer <api_key>）。

概要

AI コード指標 API は、組織レベルの AI アシストコーディング統計を提供します。コード統計概要、日次トレンド、メンバーランキング、リポジトリ一覧、ファイル拡張子統計を含みます。

主な機能

統計概要: コミットコードにおける AI 貢献の総量とシェア
日次トレンド: AI コードシェアの日次推移、Agent コードの言語別統計、Tab 補完受入率
メンバーランキング: AI コード貢献量によるメンバーランキング
リポジトリ一覧: AI コードアクティビティのあるリポジトリの一覧
ファイル拡張子: ファイルタイプ別の AI コード指標
コミット詳細: コミットレベルの AI コード帰属詳細の取得（ファイルレベルの行範囲アノテーション）

共通クエリパラメータ

以下のパラメータはすべての AI Code エンドポイントに適用されます（必須状況は各エンドポイントを参照）：

パラメータ	型	説明
`start_date`	string	開始時間；RFC 3339 形式または Unix ミリ秒タイムスタンプ
`end_date`	string	終了時間；RFC 3339 形式または Unix ミリ秒タイムスタンプ
`repo_name`	string	リポジトリ名でフィルタ
`primary_branch_only`	string	`true` に設定するとプライマリブランチのみを集計
`user_id`	string	ユーザー ID でフィルタ
`file_extensions`	string	ファイル拡張子でフィルタ、カンマ区切り（例：`.go,.ts`）

API 一覧

1. AI コード統計概要取得

GET /v1/organizations/{organization_id}/ai-code/stats/overview 組織の AI コード全体統計を取得します。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

クエリパラメータ

「共通クエリパラメータ」を参照。特に：

パラメータ	必須	説明
`start_date`	はい	開始時間
`end_date`	はい	終了時間

start_date と end_date は両方必須で、期間は 90 日以内である必要があります。

成功レスポンス（200 OK）

{
  "committedTotalLinesEdit": 50000,
  "committedAiLinesEdit": 15000,
  "acceptedLinesEdit": 18000,
  "aiShareRate": 30.0,
  "agentEditCount": 1200,
  "tabCompletionCount": 5600,
  "messageCount": 3400
}

レスポンスフィールド

フィールド	型	説明
`committedTotalLinesEdit`	int64	コミット済みコード総編集行数（追加 + 削除）
`committedAiLinesEdit`	int64	コミット済みコード中の AI 編集行数（追加 + 削除）
`acceptedLinesEdit`	int64	受け入れ済み AI 編集行数（追加 + 削除）
`aiShareRate`	float64	AI コードシェア（パーセンテージ）
`agentEditCount`	int64	Agent 編集回数
`tabCompletionCount`	int64	Tab 補完回数
`messageCount`	int64	チャットメッセージ数

2. AI コード日次トレンド取得

GET /v1/organizations/{organization_id}/ai-code/stats/daily-trend AI コードの日次トレンドデータを取得します。3 つのデータセット：AI コードシェアトレンド、言語分布トレンド、Tab 補完受入率トレンドを含みます。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

クエリパラメータ

「共通クエリパラメータ」を参照。特に：

パラメータ	必須	説明
`start_date`	はい	開始時間
`end_date`	はい	終了時間

start_date と end_date は両方必須で、期間は 90 日以内である必要があります。

成功レスポンス（200 OK）

{
  "items": [
    {
      "date": "2025-06-01T00:00:00Z",
      "aiLinesAdded": 500,
      "otherLinesAdded": 1500,
      "aiShareRate": 25.0,
      "commitCount": 30
    }
  ],
  "extItems": [
    {
      "date": "2025-06-01T00:00:00Z",
      "fileExtension": ".go",
      "totalLinesAdded": 800,
      "aiLinesAdded": 300
    }
  ],
  "nextItems": [
    {
      "date": "2025-06-01T00:00:00Z",
      "nextSuggestedCount": 200,
      "nextAcceptedCount": 120,
      "nextAcceptRate": 60.0
    }
  ]
}

レスポンスフィールド

items[] — AI コードシェアトレンド（Chart 1）

フィールド	型	説明
`date`	string	日付（ISO 8601）
`aiLinesAdded`	int64	AI 追加行数
`otherLinesAdded`	int64	非 AI 追加行数
`aiShareRate`	float64	AI コードシェア（パーセンテージ）
`commitCount`	int64	コミット数

extItems[] — Agent コード言語別分布トレンド（Chart 2）

フィールド	型	説明
`date`	string	日付（ISO 8601）
`fileExtension`	string	ファイル拡張子
`totalLinesAdded`	int64	総追加行数
`aiLinesAdded`	int64	AI 追加行数

nextItems[] — Tab 補完受入率トレンド（Chart 3）

フィールド	型	説明
`date`	string	日付（ISO 8601）
`nextSuggestedCount`	int64	提案回数
`nextAcceptedCount`	int64	受入回数
`nextAcceptRate`	float64	受入率（パーセンテージ）

3. メンバー AI コードランキング取得

GET /v1/organizations/{organization_id}/ai-code/stats/member-ranking AI コード貢献量による組織メンバーのランキングを取得します。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

クエリパラメータ

「共通クエリパラメータ」を参照。特に：

パラメータ	必須	説明
`start_date`	はい	開始時間
`end_date`	はい	終了時間

start_date と end_date は両方必須で、期間は 90 日以内である必要があります。

追加サポート：

パラメータ	型	必須	デフォルト	説明
`limit`	integer	いいえ	10	返す最大メンバー数

成功レスポンス（200 OK）

{
  "items": [
    {
      "userId": "user_abc123",
      "email": "alice@example.com",
      "displayName": "Alice",
      "totalLinesAdded": 5000,
      "aiLinesAdded": 2000,
      "aiShareRate": 40.0,
      "commitCount": 50
    }
  ]
}

レスポンスフィールド

フィールド	型	説明
`items`	array	メンバーランキングリスト
`items[].userId`	string	ユーザー ID
`items[].email`	string	メンバーメール（空の場合あり）
`items[].displayName`	string	表示名（空の場合あり）
`items[].totalLinesAdded`	int64	総追加行数
`items[].aiLinesAdded`	int64	AI 追加行数
`items[].aiShareRate`	float64	AI コードシェア（パーセンテージ）
`items[].commitCount`	int64	コミット数

4. リポジトリ一覧

GET /v1/organizations/{organization_id}/ai-code/repos 組織内の AI コードアクティビティのあるリポジトリを一覧表示します。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

クエリパラメータ

パラメータ	型	必須	デフォルト	説明
`start_date`	string	いいえ	—	開始時間
`end_date`	string	いいえ	—	終了時間
`query`	string	いいえ	—	リポジトリ名で検索
`page`	integer	いいえ	1	ページ番号（1 から開始）
`per_page`	integer	いいえ	30	1ページあたりの件数、最大 100

成功レスポンス（200 OK）

{
  "repos": [
    {
      "repoName": "my-project",
      "commitCount": 120,
      "totalLinesAdded": 8000
    }
  ],
  "totalCount": 42,
  "page": 1,
  "perPage": 30
}

レスポンスフィールド

フィールド	型	説明
`repos`	array	リポジトリリスト
`repos[].repoName`	string	リポジトリ名
`repos[].commitCount`	int64	コミット数
`repos[].totalLinesAdded`	int64	総追加行数
`totalCount`	int32	総リポジトリ数
`page`	int32	現在のページ番号
`perPage`	int32	1ページあたりの件数

5. ファイル拡張子一覧

GET /v1/organizations/{organization_id}/ai-code/file-extensions 組織内の AI コードアクティビティのファイル拡張子統計を一覧表示します。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

クエリパラメータ

パラメータ	型	必須	説明
`start_date`	string	いいえ	開始時間
`end_date`	string	いいえ	終了時間

成功レスポンス（200 OK）

{
  "fileExtensions": [
    {
      "extension": ".go",
      "changeCount": 500,
      "totalLinesAdded": 12000,
      "aiShareRate": 35.5
    }
  ]
}

レスポンスフィールド

フィールド	型	説明
`fileExtensions`	array	ファイル拡張子リスト
`fileExtensions[].extension`	string	ファイル拡張子
`fileExtensions[].changeCount`	int64	変更回数
`fileExtensions[].totalLinesAdded`	int64	総追加行数
`fileExtensions[].aiShareRate`	float64	AI コードシェア（パーセンテージ）

6. コミット AI 帰属詳細取得

POST /v1/organizations/{organization_id}/ai-code-tracking/commits/detail コミットレベルの AI コード帰属詳細を一括取得します。ファイルレベルの行範囲アノテーションを含みます。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

リクエストボディ（JSON）

フィールド	型	必須	説明
`commitHashes`	string[]	はい	コミットハッシュリスト（最大 50）
`branch`	string	いいえ	ブランチ名（クエリ範囲の制限用）

リクエスト例

{
  "commitHashes": ["abc123def456", "789ghi012jkl"],
  "branch": "main"
}

成功レスポンス（200 OK）

{
  "success": true,
  "data": {
    "commits": [
      {
        "commitHash": "abc123def456",
        "rangeAnnotations": [
          {
            "filePath": "src/main.go",
            "groups": [
              {
                "conversationId": "session-001",
                "source": "AGENT",
                "productType": "ide",
                "type": "added",
                "ranges": [
                  { "start": 47, "end": 48 },
                  { "start": 55, "end": 60 }
                ]
              }
            ]
          }
        ]
      },
      {
        "commitHash": "789ghi012jkl",

        "rangeAnnotations": [ ]

      }
    ]
  }
}

レスポンスフィールド

フィールド	型	説明
`success`	boolean	リクエストが成功したかどうか
`data.commits`	array	コミット詳細リスト（リクエスト順序を保持）
`data.commits[].commitHash`	string	コミットハッシュ
`data.commits[].rangeAnnotations`	array	ファイルレベル AI 帰属アノテーション
`data.commits[].rangeAnnotations[].filePath`	string	ファイルパス
`data.commits[].rangeAnnotations[].groups`	array	AI セッション貢献グループ
`data.commits[].rangeAnnotations[].groups[].conversationId`	string	AI セッション ID
`data.commits[].rangeAnnotations[].groups[].source`	string	ソース：`AGENT`、`NEXT`、`QUEST`、`INLINECHAT`
`data.commits[].rangeAnnotations[].groups[].productType`	string	プロダクトタイプ（小文字、例：`ide`）
`data.commits[].rangeAnnotations[].groups[].type`	string	タイプ：`added`（追加）、`deleted`（削除）
`data.commits[].rangeAnnotations[].groups[].ranges`	array	行範囲リスト
`data.commits[].rangeAnnotations[].groups[].ranges[].start`	int32	開始行番号
`data.commits[].rangeAnnotations[].groups[].ranges[].end`	int32	終了行番号

使用例

統計概要取得

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/ai-code/stats/overview?start_date=2025-06-01T00:00:00Z&end_date=2025-06-30T23:59:59Z" \
  -H "Authorization: Bearer <api_key>"

日次トレンド取得（リポジトリ指定、プライマリブランチ）

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/ai-code/stats/daily-trend?start_date=2025-06-01T00:00:00Z&end_date=2025-06-30T23:59:59Z&repo_name=my-project&primary_branch_only=true" \
  -H "Authorization: Bearer <api_key>"

メンバーランキング取得（上位 20）

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/ai-code/stats/member-ranking?start_date=2025-06-01T00:00:00Z&end_date=2025-06-30T23:59:59Z&limit=20" \
  -H "Authorization: Bearer <api_key>"

リポジトリ検索

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/ai-code/repos?query=my-project" \
  -H "Authorization: Bearer <api_key>"

ファイル拡張子統計取得

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/ai-code/file-extensions?start_date=2025-06-01T00:00:00Z" \
  -H "Authorization: Bearer <api_key>"

コミット AI 帰属詳細取得

curl -X POST "https://api.qoder.com/v1/organizations/org_xxx/ai-code-tracking/commits/detail" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{"commitHashes": ["abc123def456", "789ghi012jkl"], "branch": "main"}'

エラーコード

エラーコード	HTTP ステータス	説明
`BadRequest`	400	リクエストパラメータが無効（例：`start_date` / `end_date` 欠落、期間が 90 日超過、`commitHashes` が空または 50 件超過）
`Unauthorized`	401	API キーが欠落または無効
`Forbidden`	403	この組織へのアクセス権限なし
`InternalError`	500	サーバー内部エラー

エラーレスポンスの形式は共通仕様の エラーレスポンス を参照してください。

AI コード追跡 API

AI コード指標（集計統計）に加え、このセクションでは コミット / チェンジ レベルの詳細クエリと CSV エクスポート を提供します。認証は同じ：Authorization: Bearer <api_key>。使用前に、組織がコンソールと同じ AI コードデータ分析 機能を有効にしていることを確認してください。未有効化またはアクセス権限がない場合、API は 403 等のエラーを返す可能性があります。実際のレスポンスを参照してください。フィールドと列挙値は ライブ API と OpenAPI 定義 に基づきます。本ドキュメントは参考用です。

追跡機能

AI コード追跡 API は、コミットレベルとチェンジレベルの明細クエリおよび CSV エクスポート機能を提供し、上記の AI コード指標（集計統計）を補完します。

2 層データモデル

レイヤー	意味	ソース	利用可能なフィルタディメンション
Commit	Git コミット	コードリポジトリ（リモートにプッシュ済み）	時間、ユーザー、リポジトリ
Change	IDE 内の AI コード編集イベント	IDE クライアントからの報告（まだ Git コミットになっていない）	時間、ユーザー、ソース

Change はまだ Git コミットされていない IDE 内イベントであるため、repoName / branchName ディメンションを持ちません。

プロダクト × シナリオ分解（コミットレベル）

各コミットレコードには 12 ペア の linesAdded / linesDeleted カラムが含まれ、「プロダクト × シナリオ」で分解されます：

フィールドプレフィックス	プロダクト	シナリオ
`ideNext`	IDE（VS Code）	Tab 補完（next）
`pluginNext`	JetBrains プラグイン	Tab 補完（next）
`ideAgent`	IDE（VS Code）	Agent
`pluginAgent`	JetBrains プラグイン	Agent
`cliAgent`	CLI	Agent
`ideQuest`	IDE（VS Code）	Quest
`ideInlineChat`	IDE（VS Code）	Inline Chat
`jbInlineChat`	JetBrains プラグイン	Inline Chat
`nonAi`	—	非 AI 行（帰属不可）

主な機能

コミット明細クエリ: コミットレベルの AI コード統計を一覧表示（プロダクト × シナリオ分解付き）
コミット CSV エクスポート: 全コミットデータをストリーミングエクスポート
チェンジ明細クエリ: IDE 内 AI コード編集イベントを一覧表示（source でフィルタ可能）
チェンジ CSV エクスポート: 全チェンジデータをストリーミングエクスポート
ユーザーメール: リストとエクスポートでは利用可能な場合 userEmail を付加
メールでフィルタ: userEmail クエリパラメータでユーザーを特定可能

ページネーション

追跡 API はオフセットベースのページネーション（page + pageSize）を使用し、他のエンドポイントで一般的なカーソルベースのページネーションとは異なります。レスポンスには totalItems / totalPages が含まれ、ページネーション表示に便利です。

共通クエリパラメータ

以下のパラメータはすべての Tracking エンドポイントに適用されます：

パラメータ	型	必須	デフォルト	説明
`startDate`	string	いいえ	—	開始時間；RFC 3339 形式または Unix ミリ秒タイムスタンプ。未指定時はサーバーがプロダクトポリシーにより照会可能範囲を制約（例：最大約 90 日）。実際の動作に準拠
`endDate`	string	いいえ	現在時刻	終了時間；RFC 3339 形式または Unix ミリ秒タイムスタンプ
`userId`	string	いいえ	—	ユーザー UUID でフィルタ
`userEmail`	string	いいえ	—	ユーザーメールでフィルタ（サーバーが対応するユーザー識別子に解決）
`page`	integer	いいえ	1	ページ番号（1 から開始）
`pageSize`	integer	いいえ	100	1ページあたりの件数、最大 200

userId と userEmail の両方が指定された場合、userId が優先されます。

API 一覧

1. コミット明細一覧

GET /v1/organizations/{organization_id}/ai-code-tracking/commits コミットレベルの AI コード統計をレコードごとに一覧表示し、コミット時間の降順で並べます。各レコードにはプロダクト × シナリオの分解が含まれます。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

クエリパラメータ

「共通クエリパラメータ」を参照。追加：

パラメータ	型	必須	説明
`repoName`	string	いいえ	リポジトリ名でフィルタ

成功レスポンス（200 OK）

{
  "success": true,
  "data": {
    "items": [
      {
        "commitHash": "a1b2c3d4e5f6",
        "userId": "550e8400-e29b-41d4-a716-446655440000",
        "userEmail": "alice@example.com",
        "repoName": "my-project",
        "branchName": "main",
        "isPrimaryBranch": true,
        "totalLinesAdded": 120,
        "totalLinesDeleted": 30,
        "ideNextLinesAdded": 40,
        "ideNextLinesDeleted": 10,
        "pluginNextLinesAdded": 0,
        "pluginNextLinesDeleted": 0,
        "ideAgentLinesAdded": 50,
        "ideAgentLinesDeleted": 15,
        "pluginAgentLinesAdded": 0,
        "pluginAgentLinesDeleted": 0,
        "cliAgentLinesAdded": 0,
        "cliAgentLinesDeleted": 0,
        "ideQuestLinesAdded": 10,
        "ideQuestLinesDeleted": 0,
        "ideInlineChatLinesAdded": 5,
        "ideInlineChatLinesDeleted": 2,
        "jbInlineChatLinesAdded": 0,
        "jbInlineChatLinesDeleted": 0,
        "nonAiLinesAdded": 15,
        "nonAiLinesDeleted": 3,
        "message": "feat: add user login",
        "commitTs": "2025-06-15T10:30:00Z",
        "createdAt": "2025-06-15T10:35:00Z"
      }
    ],
    "pagination": {
      "currentPage": 1,
      "pageSize": 100,
      "totalItems": 256,
      "totalPages": 3
    }
  }
}

レスポンスフィールド

success — true はリクエスト成功を示す data.items[] — コミット明細リスト

フィールド	型	説明
`commitHash`	string	Git コミット SHA
`userId`	string	ユーザー UUID
`userEmail`	string	ユーザーメール（空の場合あり）
`repoName`	string	リポジトリ名
`branchName`	string	ブランチ名
`isPrimaryBranch`	boolean	プライマリブランチかどうか
`totalLinesAdded`	integer	総追加行数
`totalLinesDeleted`	integer	総削除行数
`ideNextLinesAdded`	integer	IDE Tab 補完追加行数
`ideNextLinesDeleted`	integer	IDE Tab 補完削除行数
`pluginNextLinesAdded`	integer	JetBrains プラグイン Tab 補完追加行数
`pluginNextLinesDeleted`	integer	JetBrains プラグイン Tab 補完削除行数
`ideAgentLinesAdded`	integer	IDE Agent 追加行数
`ideAgentLinesDeleted`	integer	IDE Agent 削除行数
`pluginAgentLinesAdded`	integer	JetBrains プラグイン Agent 追加行数
`pluginAgentLinesDeleted`	integer	JetBrains プラグイン Agent 削除行数
`cliAgentLinesAdded`	integer	CLI Agent 追加行数
`cliAgentLinesDeleted`	integer	CLI Agent 削除行数
`ideQuestLinesAdded`	integer	IDE Quest 追加行数
`ideQuestLinesDeleted`	integer	IDE Quest 削除行数
`ideInlineChatLinesAdded`	integer	IDE Inline Chat 追加行数
`ideInlineChatLinesDeleted`	integer	IDE Inline Chat 削除行数
`jbInlineChatLinesAdded`	integer	JetBrains Inline Chat 追加行数
`jbInlineChatLinesDeleted`	integer	JetBrains Inline Chat 削除行数
`nonAiLinesAdded`	integer	非 AI 追加行数
`nonAiLinesDeleted`	integer	非 AI 削除行数
`message`	string	コミットメッセージ（空の場合あり）
`commitTs`	string	コミット時間（ISO 8601）
`createdAt`	string	レコード作成時間（ISO 8601）

data.pagination — ページネーション情報

フィールド	型	説明
`currentPage`	integer	現在のページ番号
`pageSize`	integer	1ページあたりの件数
`totalItems`	integer	総レコード数
`totalPages`	integer	総ページ数

2. コミット CSV エクスポート

GET /v1/organizations/{organization_id}/ai-code-tracking/commits/export コミットデータをストリーミング CSV 形式でエクスポートします。サーバーがページネーション集計を自動処理するため、呼び出し側でのページネーションは不要です。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

クエリパラメータ

「共通クエリパラメータ」を参照。追加：

パラメータ	型	必須	説明
`repoName`	string	いいえ	リポジトリ名でフィルタ

成功レスポンス（200 OK）

Content-Type: text/csv; charset=utf-8
Content-Disposition: attachment; filename="ai-code-commits.csv"

CSV カラムヘッダー（注：CSV は userName を保持、JSON レスポンスでは削除済み）：

commitHash,userId,userEmail,userName,repoName,branchName,isPrimaryBranch,
totalLinesAdded,totalLinesDeleted,
ideNextLinesAdded,ideNextLinesDeleted,pluginNextLinesAdded,pluginNextLinesDeleted,
ideAgentLinesAdded,ideAgentLinesDeleted,pluginAgentLinesAdded,pluginAgentLinesDeleted,
cliAgentLinesAdded,cliAgentLinesDeleted,ideQuestLinesAdded,ideQuestLinesDeleted,
ideInlineChatLinesAdded,ideInlineChatLinesDeleted,jbInlineChatLinesAdded,jbInlineChatLinesDeleted,
nonAiLinesAdded,nonAiLinesDeleted,message,commitTs,createdAt

3. チェンジ明細一覧

GET /v1/organizations/{organization_id}/ai-code-tracking/changes IDE 内の AI コード編集イベント（action=suggested レコードのみ）をイベント時間降順で一覧表示します。

Change はまだ Git コミットされていない IDE 内イベントであるため、repoName フィルタはサポートされません。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

クエリパラメータ

「共通クエリパラメータ」を参照。追加：

パラメータ	型	必須	説明
`source`	string	いいえ	利用シナリオでフィルタ。値：`AGENT`、`NEXT`、`QUEST`、`INLINECHAT`

成功レスポンス（200 OK）

{
  "success": true,
  "data": {
    "items": [
      {
        "changeId": "chg_abc123",
        "userId": "550e8400-e29b-41d4-a716-446655440000",
        "userEmail": "alice@example.com",
        "source": "AGENT",
        "model": "efficient",
        "totalLinesAdded": 45,
        "totalLinesDeleted": 12,
        "metadata": [
          {
            "fileName": "main.go",
            "fileExtension": ".go",
            "linesAdded": 30,
            "linesDeleted": 8
          },
          {
            "fileName": "utils.go",
            "fileExtension": ".go",
            "linesAdded": 15,
            "linesDeleted": 4
          }
        ],
        "createdAt": "2025-06-15T10:28:00Z"
      }
    ],
    "pagination": {
      "currentPage": 1,
      "pageSize": 100,
      "totalItems": 1024,
      "totalPages": 11
    }
  }
}

レスポンスフィールド

success — true はリクエスト成功を示す data.items[] — チェンジ明細リスト

フィールド	型	説明
`changeId`	string	変更イベント一意識別子
`userId`	string	ユーザー UUID
`userEmail`	string	ユーザーメール（空の場合あり）
`source`	string	利用シナリオ（大文字）：`NEXT`、`AGENT`、`QUEST`、`INLINECHAT`
`model`	string	モデルティア：`lite`、`efficient`、`auto`（空の場合あり）
`totalLinesAdded`	integer	総追加行数
`totalLinesDeleted`	integer	総削除行数
`metadata`	array	ファイルレベル変更明細（空の場合あり）
`metadata[].fileName`	string	ファイル名
`metadata[].fileExtension`	string	ファイル拡張子
`metadata[].linesAdded`	integer	ファイル追加行数
`metadata[].linesDeleted`	integer	ファイル削除行数
`createdAt`	string	イベント時間（ISO 8601）

data.pagination — ページネーション情報

フィールド	型	説明
`currentPage`	integer	現在のページ番号
`pageSize`	integer	1ページあたりの件数
`totalItems`	integer	総レコード数
`totalPages`	integer	総ページ数

4. チェンジ CSV エクスポート

GET /v1/organizations/{organization_id}/ai-code-tracking/changes/export チェンジデータをストリーミング CSV 形式でエクスポートします。サーバーがページネーション集計を自動処理するため、呼び出し側でのページネーションは不要です。

CSV エクスポートはフラット形式で、metadata（ファイルレベル明細）は含みません。

パスパラメータ

パラメータ	型	必須	説明
`organization_id`	string	はい	組織 ID

クエリパラメータ

「共通クエリパラメータ」を参照。追加：

パラメータ	型	必須	説明
`source`	string	いいえ	利用シナリオでフィルタ。値：`AGENT`、`NEXT`、`QUEST`、`INLINECHAT`

成功レスポンス（200 OK）

Content-Type: text/csv; charset=utf-8
Content-Disposition: attachment; filename="ai-code-changes.csv"

CSV カラムヘッダー：

changeId,userId,userEmail,source,model,totalLinesAdded,totalLinesDeleted,createdAt

使用例

コミット明細クエリ（リポジトリでフィルタ）

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/ai-code-tracking/commits?startDate=2025-06-01T00:00:00Z&endDate=2025-06-30T23:59:59Z&repoName=my-project&pageSize=50" \
  -H "Authorization: Bearer <api_key>"

メールでユーザーのコミットをクエリ

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/ai-code-tracking/commits?startDate=2025-06-01T00:00:00Z&userEmail=alice@example.com" \
  -H "Authorization: Bearer <api_key>"

コミット CSV エクスポート

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/ai-code-tracking/commits/export?startDate=2025-06-01T00:00:00Z" \
  -H "Authorization: Bearer <api_key>" \
  -o ai-code-commits.csv

チェンジ明細クエリ（ソースでフィルタ）

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/ai-code-tracking/changes?startDate=2025-06-01T00:00:00Z&source=QUEST&pageSize=50" \
  -H "Authorization: Bearer <api_key>"

チェンジ CSV エクスポート

curl -X GET "https://api.qoder.com/v1/organizations/org_xxx/ai-code-tracking/changes/export?startDate=2025-06-01T00:00:00Z" \
  -H "Authorization: Bearer <api_key>" \
  -o ai-code-changes.csv

エラーコード

エラーコード	HTTP ステータス	説明
`Unauthorized`	401	API キーが欠落または無効
`Forbidden`	403	この組織へのアクセス権限なし
`BadRequest`	400	リクエストパラメータが無効（例：`organization_id` / `userId` が有効な UUID でない）
`InternalError`	500	サーバー内部エラー

エラーレスポンスの形式は共通仕様の エラーレスポンス を参照してください。

使用量 API

​このドキュメントについて

​前提条件

​概要

​主な機能

​共通クエリパラメータ

​API 一覧

​1. AI コード統計概要取得

​パスパラメータ

​クエリパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​2. AI コード日次トレンド取得

​パスパラメータ

​クエリパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​3. メンバー AI コードランキング取得

​パスパラメータ

​クエリパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​4. リポジトリ一覧

​パスパラメータ

​クエリパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​5. ファイル拡張子一覧

​パスパラメータ

​クエリパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​6. コミット AI 帰属詳細取得

​パスパラメータ

​リクエストボディ（JSON）

​リクエスト例

​成功レスポンス（200 OK）

​レスポンスフィールド

​使用例

​統計概要取得

​日次トレンド取得（リポジトリ指定、プライマリブランチ）

​メンバーランキング取得（上位 20）

​リポジトリ検索

​ファイル拡張子統計取得

​コミット AI 帰属詳細取得

​エラーコード

​AI コード追跡 API

​追跡機能

​2 層データモデル

​プロダクト × シナリオ分解（コミットレベル）

​主な機能

​ページネーション

​共通クエリパラメータ

​API 一覧

​1. コミット明細一覧

​パスパラメータ

​クエリパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​2. コミット CSV エクスポート

​パスパラメータ

​クエリパラメータ

​成功レスポンス（200 OK）

​3. チェンジ明細一覧

​パスパラメータ

​クエリパラメータ

​成功レスポンス（200 OK）

​レスポンスフィールド

​4. チェンジ CSV エクスポート

​パスパラメータ

​クエリパラメータ

​成功レスポンス（200 OK）

​使用例

​コミット明細クエリ（リポジトリでフィルタ）

​メールでユーザーのコミットをクエリ

​コミット CSV エクスポート

​チェンジ明細クエリ（ソースでフィルタ）

​チェンジ CSV エクスポート

​エラーコード

このドキュメントについて

前提条件

概要

主な機能

共通クエリパラメータ

API 一覧

1. AI コード統計概要取得

パスパラメータ

クエリパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

2. AI コード日次トレンド取得

パスパラメータ

クエリパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

3. メンバー AI コードランキング取得

パスパラメータ

クエリパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

4. リポジトリ一覧

パスパラメータ

クエリパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

5. ファイル拡張子一覧

パスパラメータ

クエリパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

6. コミット AI 帰属詳細取得

パスパラメータ

リクエストボディ（JSON）

リクエスト例

成功レスポンス（200 OK）

レスポンスフィールド

使用例

統計概要取得

日次トレンド取得（リポジトリ指定、プライマリブランチ）

メンバーランキング取得（上位 20）

リポジトリ検索

ファイル拡張子統計取得

コミット AI 帰属詳細取得

エラーコード

AI コード追跡 API

追跡機能

2 層データモデル

プロダクト × シナリオ分解（コミットレベル）

主な機能

ページネーション

共通クエリパラメータ

API 一覧

1. コミット明細一覧

パスパラメータ

クエリパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

2. コミット CSV エクスポート

パスパラメータ

クエリパラメータ

成功レスポンス（200 OK）

3. チェンジ明細一覧

パスパラメータ

クエリパラメータ

成功レスポンス（200 OK）

レスポンスフィールド

4. チェンジ CSV エクスポート

パスパラメータ

クエリパラメータ

成功レスポンス（200 OK）

使用例

コミット明細クエリ（リポジトリでフィルタ）

メールでユーザーのコミットをクエリ

コミット CSV エクスポート

チェンジ明細クエリ（ソースでフィルタ）

チェンジ CSV エクスポート

エラーコード