Safie Developers仕様変更のお知らせ ※完了済み
お客様各位
いつもSafie Developers(https://developers.safie.link/)をご利用いただきありがとうございます。来月のバージョンアップに伴い、以下の仕様変更を予定しておりますので、事前にお知らせさせていただきます。
変更予定日
2023年5月31日(水)を予定しています。
変更内容
1. ユーザー認証画面のデザイン変更
ユーザー認証画面のUIデザイン変更を行います。これによりユーザーは、アクセスを許可する権限の範囲を正確に把握することができます。
【変更前】
【変更後】
Case 1: すべての権限でのアクセス許可を要求する場合
Case 2: 特定の権限でのアクセス許可を要求する場合
2. 認証時のエラー情報の変更
ユーザー認証API (GET /v2/auth/authorize) のエラー応答の仕様を、以下の通り変更いたします。
response_typeおよびscopeパラメータが不正な場合、リダイレクト先にエラー情報を返すようになります。これにより、連携先のサイトでエラー内容を正確に確認していただけるようになります。
1. redirect_uriに不正な値が指定された場合
【変更前】
404エラーページを表示
【変更後】
ステータスコード400で以下のjsonエラーメッセージを返却
HTTP/1.1 400 Bad Request
Content-Type: application/json
{
"detail": {
"type": "invalid_params",
"message": "Invalid redirect_uri"
}
}
2. response_typeに不正な値が指定された場合
【変更前】
404エラーページを表示
【変更後】
エラーコード "unsupported_response_type"を付与し、指定されたredirect_uriへリダイレクト
HTTP/1.1 302 Found
Location: {redirect_uri}?error=unsupported_response_type[&state={ユーザーリクエストのstate}]
3. scopeに不正な値が指定された場合
【変更前】
ステータスコード422を返却、もしくは404エラーページを表示
【変更後】
エラーコード "invalid_scope" を付与し、指定されたredirect_uriへリダイレクト
HTTP/1.1 302 Found
Location: {redirect_uri}?error=invalid_scope[&state={ユーザーリクエストのstate}]
ご質問・お問い合わせ
上記の通り仕様変更を予定しています。お使いいただいている画面や機能が変更されますので、ご注意くださいませ。
また変更内容に関する事前のご質問・お問い合わせについては、お問い合わせフォーム(https://safie.jp/contact/api/)よりご連絡ください。
お客様にご満足いただけるサービスを提供できるよう引き続き努めてまいりますので、今後ともよろしくお願い申し上げます。
●2023年5月31日追記
お知らせしていた内容の通り、仕様変更が完了いたしました。
- この記事のカテゴリ