1. 概要

APIを利用するためのアクセストークンの有効期限が切れた場合に、アクセストークンと同時に取得したリフレッシュトークンを用いて、アクセストークンとリフレッシュトークンの再発行を行う。

2. アクセス仕様

項目	内容
プロトコル	HTTPS
メソッド	POST
URL	https://auth.infomart.co.jp/openam/oauth2/access_token?realm=/api

3. リクエスト(HTTPS GET, UTF-8)

パラメータ名	名前	型	長さ・範囲	必須	備考
grant_type	権限種別	文字列		○	以下の固定値を指定する。 "refresh_token"：リフレッシュトークン
refresh_token	リフレッシュトークン	文字列		○	アクセストークン発行時に取得したリフレッシュトークン。
client_id	クライアントID	文字列		○	サービス利用申請時に発行されたクライアントID。
client_secret	クライアントシークレットID	文字列		○	サービス利用申請時に発行されたクライアントシークレットID。

• ex)リクエストイメージ

POST https://auth.infomart.co.jp/openam/oauth2/access_token?realm=/api HTTP/1.1
Host: auth.infomart.co.jp
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token
refresh_token=f21b49b0-31b0-4441-8cc9-0ef7e14ae738
client_id=sample_client_id
client_secret=sample_secret





4. レスポンス(JSON, UTF-8)

成功時

要素名・階層	要素内容	型	必須	備考
scope	スコープ	文字列	○	アクセストークンの持つスコープ。
exires_in	有効期限	数字	○	アクセストークンの有効期限（単位：秒）
token_type	種類	文字列	○	アクセストークンの種類。 以下の固定値を返却する。 "Bearer"
access_token	アクセストークン	文字列	○	発行されたアクセストークン。 有効期限は5分となっている。
refresh_token	リフレッシュトークン	文字列	○	アクセストークンの再発行に使用するリフレッシュトークン。 有効期限は31日となっている。

• ex)リクエストイメージ　※便宜上改行している。

{
"scope":"openid profile email qualified",
"expires_in":180,
"token_type":"Bearer",
"access_token":"db36aeb3-021e-4a51-aaa6-b94c0da4542e",
"refresh_token":"f21b49b0-31b0-4441-8cc9-0ef7e14ae738"
}





5. 処理詳細

5.1. 期限切れアクセストークン再発行リクエスト

利用システムより認証サーバへ期限切れになったアクセストークンの再発行リクエストを行う。
※アクセストークン発行処理へ発行するリクエストは「３．リクエスト(HTTPS GET, UTF-8)」を参照。

5.2. リクエストチェック

認証サーバにて利用システムからのリクエストをチェックする。
不備があった場合、HTTPステータスコード「400 Bad Request」を返却する。

5.3. アクセストークン・リフレッシュトークン発行

認証サーバにてアクセストークンとリフレッシュトークンを再発行し、レスポンスとして返却する。

6. 備考・補足

特になし。