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日追記
 お知らせしていた内容の通り、仕様変更が完了いたしました。


この記事のカテゴリ