D1連携を移行する

D1 API v1とv2の変更点と、安全に移行する方法を理解する。

D1 は D1 API の 2 世代を提供します：

• v1 API は次を使用します /v1/ を URL パスに含みます。
• v2 API は次を使用します /v2/ を URL パスに含みます。

v2 は新しい統合に推奨されるオプションです。 また、エンドユーザーおよびカード管理のための新機能と更新されたモデルを導入します。

移行すべきタイミング

イシュアのバックエンドが現在 v1 エンドポイントを呼び出しており、次のことを行いたい場合は移行してください：

• v2 専用の機能（例：新しい認可制御）を使用する。
• エンドユーザーおよびカードのライフサイクル操作に対して最新の D1 API モデルに合わせる。
• 新規および既存のカードに対して単一の API バージョンに標準化する。

D1 API は用語を使用します consumer はエンドユーザーを指します。 このドキュメントでは end userを使用し、API フィールド名はそのままにします（例えば、 consumerId).

推奨される移行アプローチ

案内された v1 から v2 への移行フローを使用してください：

• 次に従ってください v2 へ移行 でエンドツーエンドの手順を確認してください。
• ルーティングする 新しい登録 をまず v2 に送ってください。
• 既存データを移行する（Thales が対応）。
• その後、ライフサイクルトラフィック（サスペンド、再開、更新、交換、削除）を v2 に移行してください。

関連ガイド

• エンドユーザーとカードを登録する
• エンドユーザーとカードを管理する

API リファレンス

• D1 v1 API リファレンス