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

# バージョン管理

> X API のバージョン管理の仕組み、v1.1、v2、Enterprise の違い、そしてどの変更が破壊的で、どの変更が追加的な更新と見なされるかを解説します。

X API はエンドポイントパスにバージョン番号を使用し、安定性を確保しつつ進化を可能にします。バージョン管理戦略を理解することで、統合の計画を立て、最新の状態を保てます。

***

## 現在のバージョン

| Version        | Status | Description               |
| :------------- | :----- | :------------------------ |
| **v2**         | 現行     | モダンなエンドポイント、柔軟な料金、すべての新機能 |
| **v1.1**       | Legacy | 限定的なサポート、最小限の更新           |
| **Enterprise** | 利用可能   | 専任サポート付きの大容量アクセス          |

<Tip>
  すべての新規プロジェクトには **X API v2** を使用してください。ここに新機能がすべて追加されます。
</Tip>

***

## URL 内のバージョン

バージョン番号はエンドポイントパスに現れます。

```
https://api.x.com/2/tweets
                   ^
                   version
```

***

## 破壊的変更と非破壊的変更

### 破壊的変更（コードの更新が必要）

これらの変更はメジャーバージョンアップ時のみ発生します。

* エンドポイントの削除
* レスポンスフィールドの削除
* クエリパラメータの削除
* 新しい必須パラメータの追加
* フィールドのデータ型の変更
* フィールドやリソースの名称変更
* レスポンスコードやエラータイプの変更
* 認可スコープの変更

### 非破壊的変更（追加）

これらはバージョン変更なしにいつでも発生し得ます。

* 新しいエンドポイントの追加
* 新しいオプションパラメータの追加
* 新しいレスポンスフィールドの追加
* 新しい OAuth スコープの追加
* エラーメッセージテキストの変更
* プライバシー/セキュリティ上の理由でフィールドを null にする

***

## リリーススケジュール

| Type          | Frequency | Notice            |
| :------------ | :-------- | :---------------- |
| **メジャーバージョン** | 年 1 回以下   | 移行ガイドを提供          |
| **非破壊的変更**    | 継続的       | changelog を更新     |
| **セキュリティパッチ** | 必要に応じて    | 現行バージョンに適用される場合あり |

***

## 廃止ポリシー

新しいメジャーバージョンをリリースする際:

1. **廃止（Deprecation）**: 以前のバージョンが廃止予定としてマークされる
2. **サポート期間**: 廃止予定のバージョンは定められた期間動作を継続
3. **廃止（Retirement）**: 廃止予定のバージョンが削除される

### 定義

| Status         | Meaning                  |
| :------------- | :----------------------- |
| **Active**     | 新機能と修正で完全にサポート           |
| **Deprecated** | 新機能なし、重大なバグのみ対応、使用を推奨しない |
| **Retired**    | アクセス不可                   |

***

## 最新情報の把握

変更に関する通知を受け取りましょう。

<CardGroup cols={2}>
  <Card title="Changelog" icon="https://mintcdn.com/x-preview/szd6PKNMlRQoyyAo/icons/xds/icon-history.svg?fit=max&auto=format&n=szd6PKNMlRQoyyAo&q=85&s=6afe17587c08ee621e37afde19a07ff1" href="/changelog" width="24" height="24" data-path="icons/xds/icon-history.svg">
    プラットフォームのすべての変更と更新。
  </Card>

  <Card title="Forum Announcements" icon="bullhorn" href="https://devcommunity.x.com/c/announcements/22">
    破壊的変更のお知らせ。
  </Card>

  <Card title="@XDevelopers" icon="https://mintcdn.com/x-preview/SxzTbJaLjs3MidH1/icons/xds/icon-logo-x.svg?fit=max&auto=format&n=SxzTbJaLjs3MidH1&q=85&s=53e3153f3b8d6efdad31484ef133b274" href="https://x.com/XDevelopers" width="24" height="24" data-path="icons/xds/icon-logo-x.svg">
    プラットフォームのニュースと更新。
  </Card>

  <Card title="Newsletter" icon="https://mintcdn.com/x-preview/UIyI4eSwiP2OpODQ/icons/xds/icon-envelope.svg?fit=max&auto=format&n=UIyI4eSwiP2OpODQ&q=85&s=fbd38dbcd64d8688d3c9912ac30c4621" href="/newsletter" width="24" height="24" data-path="icons/xds/icon-envelope.svg">
    月次ダイジェスト。
  </Card>
</CardGroup>

***

## 移行リソース

新しいバージョンがリリースされる際、以下を提供します。

* **移行ガイド**: 段階的なアップグレード手順
* **エンドポイントのマッピング**: v1 と v2 の対応
* **データ形式の変更**: オブジェクトモデルの相違

<CardGroup cols={2}>
  <Card title="移行の概要" icon="route" href="/x-api/migrate/overview">
    現在の移行ガイダンス。
  </Card>

  <Card title="エンドポイントマップ" icon="map" href="/x-api/migrate/x-api-endpoint-map">
    v1 から v2 へのエンドポイントマッピング。
  </Card>
</CardGroup>

***

## ベストプラクティス

<CardGroup cols={2}>
  <Card title="v2 を使用" icon="arrow-up">
    新規プロジェクトは最新バージョンから始めましょう。
  </Card>

  <Card title="お知らせを監視" icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-bell.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=5e0b3dcfbb39ba3d4619931d7cd927d1" width="24" height="24" data-path="icons/xds/icon-bell.svg">
    changelog とフォーラムの更新を購読しましょう。
  </Card>

  <Card title="変更をテスト" icon="flask">
    本番更新前に開発環境でテストしましょう。
  </Card>

  <Card title="移行を計画" icon="calendar">
    廃止まで待たずにアップグレードしましょう。
  </Card>
</CardGroup>