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

# Teams OpenAPI 概要

> Teams OpenAPI の対象ユーザー、推奨される閲読順序、前提条件。

**Qoder Teams OpenAPI** を使用して、組織レベルでメンバー、使用量、AI コード指標を取得できます。すべてのエンドポイントには **API キー** が必要であり、そのキーに紐づいた組織のデータのみにアクセスできます。

## 対象ユーザー

* **管理者**、または外部システムで Teams データを自動取得する必要がある**インテグレーション / 運用 / データ**担当者。
* **HTTPS**、**JSON**、**REST** に慣れた開発者。

## 推奨閲覧順序

サイドバーの **アカウント → OpenAPI** セクションに従ってください：

1. **[共通仕様](/ja/account/teams/openapi/conventions)** — ベース URL、認証、ページネーション、エラー、命名規則。
2. **[API キーの取得](/ja/account/teams/openapi/get-api-key)** — コンソールでキーを作成。
3. **[API キーのセキュリティ](/ja/account/teams/openapi/api-key-security)** — 保管、ローテーション、インシデント対応。
4. **[メンバー API](/ja/account/teams/openapi/members)** — メンバー、統計、クォータ、Add-On Cap。
5. **[使用量 API](/ja/account/teams/openapi/usage)** — Credits 使用イベントと集計（メンバー・組織スコープ）。
6. **[AI コード指標 & 追跡](/ja/account/teams/openapi/ai-code-metrics)** — 集計、コミット帰属、詳細・エクスポート API。

## スコープ（概要）

| トピック    | 詳細                                                             |
| ------- | -------------------------------------------------------------- |
| 認証      | `Authorization: Bearer <api_key>`；キーは組織に紐づきます。                 |
| データスコープ | その組織のデータのみ；エンドポイントごとのフィールド。                                    |
| ベースパス   | ほとんどのルートは `/v1/organizations/{organization_id}` 配下です（共通仕様を参照）。 |

<Warning>
  API キーは、製品の権限モデル内で作成者と**ほぼ同じアクセス権限**を持ちます。キーをリポジトリ、チャット、メールに貼り付けないでください。
</Warning>

## Organization ID

Qoder Web コンソールの組織設定または URL から **`organization_id`** を取得してください。サンプル内のプレースホルダー `org_xxx` を実際の ID に置き換えてください。

## サポート

エラーが発生した場合、レスポンスボディの **`requestId`** を記録し、Qoder サポートにお問い合わせください。
