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

# バージョニング

> X API のバージョニング戦略と廃止ポリシー

X API は、進化を可能にしつつ安定性を確保するために、エンドポイントのパスにバージョン番号を使用します。このバージョニング戦略を理解することで、連携を計画し、常に最新の状態を維持しやすくなります。

***

<div id="current-versions">
  ## 現行バージョン
</div>

| バージョン          | ステータス | 説明                         |
| :------------- | :---- | :------------------------- |
| **v2**         | 現行    | 最新のエンドポイント、柔軟な料金体系、すべての新機能 |
| **v1.1**       | レガシー  | サポートは限定的で、更新は最小限           |
| **Enterprise** | 利用可能  | 専任サポート付きの大量データアクセス         |

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

***

<div id="version-in-urls">
  ## URL のバージョン
</div>

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

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

***

<div id="breaking-vs-non-breaking-changes">
  ## 非互換な変更と互換性を維持する変更
</div>

<div id="breaking-changes-require-code-updates">
  ### 破壊的変更 (コードの更新が必要)
</div>

これらの変更はメジャーバージョンの更新時にのみ行われます。

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

<div id="non-breaking-changes-additive">
  ### 後方互換性を壊さない変更 (追加的)
</div>

これらはバージョンを変更せずにいつでも行われる可能性があります：

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

***

<div id="release-schedule">
  ## リリーススケジュール
</div>

| 種別             | 頻度     | 通知                      |
| :------------- | :----- | :---------------------- |
| **メジャーバージョン**  | 年1回を上限 | マイグレーションガイドを提供します       |
| **非互換を伴わない変更** | 随時     | 変更履歴 (Changelog) を更新します |
| **セキュリティパッチ**  | 必要に応じて | 現行バージョンに適用される場合があります    |

***

<div id="deprecation-policy">
  ## 非推奨ポリシー
</div>

新しいメジャーバージョンをリリースする際の流れは次のとおりです。

1. **非推奨化**: 以前のバージョンが非推奨としてマークされます
2. **サポート期間**: 非推奨となったバージョンは、定められた期間中は引き続き利用できます
3. **廃止**: 非推奨バージョンは削除されます

<div id="definitions">
  ### 定義
</div>

| ステータス          | 意味                                 |
| :------------- | :--------------------------------- |
| **Active**     | 新機能と不具合修正が継続的に提供されている状態            |
| **Deprecated** | 新機能の追加は行わず、重大なバグのみ修正する状態。利用は推奨されない |
| **Retired**    | すでに利用・アクセスできない状態                   |

***

<div id="staying-informed">
  ## 最新情報を入手する
</div>

変更に関する通知を受け取るには:

<CardGroup cols={2}>
  <Card title="Changelog" icon="clock-rotate-left" href="/ja/changelog">
    プラットフォームに関するすべての変更とアップデート。
  </Card>

  <Card title="フォーラムのお知らせ" icon="bullhorn" href="https://devcommunity.x.com/c/announcements/22">
    後方互換性に影響する変更の通知。
  </Card>

  <Card title="@XDevelopers" icon="x-twitter" href="https://x.com/XDevelopers">
    プラットフォームのニュースとアップデート。
  </Card>

  <Card title="ニュースレター" icon="envelope" href="/ja/newsletter">
    月次ダイジェスト。
  </Card>
</CardGroup>

***

<div id="migration-resources">
  ## 移行リソース
</div>

新しいバージョンがリリースされた際には、次の内容を提供します。

* **移行ガイド**: ステップバイステップのアップグレード手順
* **エンドポイント対応表**: v1 から v2 への対応関係
* **データ形式の変更点**: オブジェクトモデルの違い

<CardGroup cols={2}>
  <Card title="移行の概要" icon="route" href="/ja/x-api/migrate/overview">
    最新の移行に関するガイダンスです。
  </Card>

  <Card title="エンドポイント対応表" icon="map" href="/ja/x-api/migrate/x-api-endpoint-map">
    v1 から v2 へのエンドポイント対応表です。
  </Card>
</CardGroup>

***

<div id="best-practices">
  ## ベストプラクティス
</div>

<CardGroup cols={2}>
  <Card title="v2 を利用する" icon="arrow-up">
    新しいプロジェクトは最新バージョンで開始してください。
  </Card>

  <Card title="アナウンスを確認する" icon="bell">
    変更履歴とフォーラムの更新を購読してください。
  </Card>

  <Card title="変更をテストする" icon="flask">
    本番環境を更新する前に開発環境でテストしてください。
  </Card>

  <Card title="移行を計画する" icon="calendar">
    非推奨になるまでアップグレードを待たないでください。
  </Card>
</CardGroup>