post https://api.saisoncard.co.jp/auth/token
アクセストークン/リフレッシュトークンを使用して、アクセストークンの更新を要求する。
成功した場合、新しいアクセストークンを発行する。
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) | その他のサーバサイドが原因のエラー。 |