現行バージョン
| バージョン | ステータス | 説明 |
|---|---|---|
| v2 | 現行 | 最新のエンドポイント、柔軟な料金体系、すべての新機能 |
| v1.1 | レガシー | サポートは限定的で、更新は最小限 |
| Enterprise | 利用可能 | 専任サポート付きの大量データアクセス |
URL のバージョン
非互換な変更と互換性を維持する変更
破壊的変更 (コードの更新が必要)
- エンドポイントの削除
- レスポンスフィールドの削除
- クエリパラメータの削除
- 新しい必須パラメータの追加
- フィールドのデータ型の変更
- フィールドまたはリソース名の変更
- レスポンスコードまたはエラー type の変更
- 認可スコープの変更
後方互換性を壊さない変更 (追加的)
- 新しいエンドポイントの追加
- 新しいオプションパラメータの追加
- 新しいレスポンスフィールドの追加
- 新しい OAuth スコープの追加
- エラーメッセージの文言の変更
- プライバシー／セキュリティ上の理由によるフィールドの null 設定
リリーススケジュール
| 種別 | 頻度 | 通知 |
|---|---|---|
| メジャーバージョン | 年1回を上限 | マイグレーションガイドを提供します |
| 非互換を伴わない変更 | 随時 | 変更履歴 (Changelog) を更新します |
| セキュリティパッチ | 必要に応じて | 現行バージョンに適用される場合があります |
非推奨ポリシー
- 非推奨化: 以前のバージョンが非推奨としてマークされます
- サポート期間: 非推奨となったバージョンは、定められた期間中は引き続き利用できます
- 廃止: 非推奨バージョンは削除されます
定義
| ステータス | 意味 |
|---|---|
| Active | 新機能と不具合修正が継続的に提供されている状態 |
| Deprecated | 新機能の追加は行わず、重大なバグのみ修正する状態。利用は推奨されない |
| Retired | すでに利用・アクセスできない状態 |
最新情報を入手する
Changelog
プラットフォームに関するすべての変更とアップデート。
フォーラムのお知らせ
後方互換性に影響する変更の通知。
@XDevelopers
プラットフォームのニュースとアップデート。
ニュースレター
月次ダイジェスト。
移行リソース
- 移行ガイド: ステップバイステップのアップグレード手順
- エンドポイント対応表: v1 から v2 への対応関係
- データ形式の変更点: オブジェクトモデルの違い
移行の概要
最新の移行に関するガイダンスです。
エンドポイント対応表
v1 から v2 へのエンドポイント対応表です。
ベストプラクティス
v2 を利用する
新しいプロジェクトは最新バージョンで開始してください。
アナウンスを確認する
変更履歴とフォーラムの更新を購読してください。
変更をテストする
本番環境を更新する前に開発環境でテストしてください。
移行を計画する
非推奨になるまでアップグレードを待たないでください。