トークン再発行

アクセストークン/リフレッシュトークンを使用して、アクセストークンの更新を要求する。 成功した場合、新しいアクセストークンを発行する。 TEA006

RESPONSE

項目名(論理)

項目名(物理)

属性

最大桁数

[byte]

必須

項目説明

備考

アクセストークン

access_token

半角英数記

64

発行されたアクセストークン。

アクセストークン有効期間

expires_in

半角数(数値)

10

アクセストークンの有効期間を表す秒数。付加されていなければ無期限。

3600という値が付加されていた場合、サーバによってレスポンスが生成されてから1時間後にアクセストークンが失効することを表す。

リフレッシュトークン

refresh_token

半角英数記

64

発行されたリフレッシュトークン。
同一のエンドユーザのアクセス許可を使って新しいアクセストークンを取得するのに利用される。

エラーコード

error

半角英数記

32

発生したエラー内容を示すコード。
※ エラー時の場合のみ必須(この場合、他の項目はすべて無しとなる)。
正常終了時は不要

※エラーコードの値は、「API処理結果コード」を参照のこと。

API処理結果コード

パラメータ "error" の値

HTTP status code

説明

200

正常終了

invalid_request

400 (Bad request)

リクエストが必須のパラメータを含んでいない。
サポートしていないパラメータないしパラメータ値を含む、あるいは形式に問題がある。

invalid_grant

400 (Bad request)

リフレッシュトークン が不正, 有効期限切れ, 失効している

unsupported_grant_type

400 (Bad request)

認可サーバは指定された方法によるアクセストークンの発行をサポートしていない。

maintenance

503 (Service Unavailable)

メンテナンス中の場合(セゾンコネクト)

temporarily_unavailable

503 (Service Unavailable)

一時的な過負荷によってリクエストを扱うことができない。

server_error

500 (Internal Server Error)

その他のサーバサイドが原因のエラー。

Language
Click Try It! to start a request and see the response here!