バージョン6.xの変更点#
エラーレスポンスパラメータをerror_descriptionのみに統一しました。
一部のリクエスト/レスポンスにおいて、パラメータ名を下記の使い分けに従い変更しました。
CallbackとRedirectは、どちらも特定の処理後に別の場所へ遷移するという点で似ていますが、次の定義を設け、使い分けております。Redirect：あるURLから別のURLへブラウザを直接移動させる際に使用。
Callback： 特定の処理（認証など）が完了した後に、元の場所（クライアント）に結果を通知する際に使用。
バージョン5.x以前：/serial/callback/request
バージョン6.x以降：/serial/redirect/request
バージョン5.x以前：client_redirect_url
バージョン6.x以降：redirect_url
※機能・動作に変更はありません。
シリアル番号をはじめとする本プロセスにおいて取得されたデータはxIDには保管されず、クライアントがデータを取得した後、xIDからは削除されます。クライアントにおいて適切に管理・保管してください。
Serialについて#
シーケンス#
利用者フロー#
SerialRedirectについて#
Serialとの違い#
本エンドポイントを用いてSerialプロセスが開始された場合、自動的にxIDアプリへ遷移してプロセスが開始されます。
当該プロセスが完了した後、本要求を実行したサービスに自動的に戻ります。
xIDアプリからの自動遷移先はデフォルトブラウザとなります（特定のアプリへ遷移させたい場合の対策は下記のNoteを参照）。
特定のアプリへ遷移が必要な場合は、SerialRedirectリクエストのパラメータであるcallback_urlにクライアントアプリのユニバーサルリンクまたはアプリリンクを指定することをご検討ください。
リクエスト元からxID アプリへの自動遷移#
レスポンスに含まれるcallback_urlを呼び出していただくことで、xIDアプリに自動遷移し、Serialプロセスが開始されます。xIDアプリからリクエスト元への自動遷移#
Serialのプロセス終了後は、リクエスト時に指定されたURLへ自動遷移いたします。その際、当該手続きのステータス（succeeded, canceled）が付与されますので、ステータスに応じてリクエスト元でクライアントに表示する画面を制御することができます。なお、本エンドポイントでは、署名データなどの送信先（callback_url）と、利用者の画面遷移先（redirect_url）が独立しています。データは callback_url へ送信され、利用者の画面は redirect_url へ遷移します。シーケンス#
利用者フロー#
