メインコンテンツへスキップ

​
概要

本ドキュメントでは、既に発行済のアクセストークン一覧を取得する方法について解説します。
本機能は Authlete 2.0 以降でのみ利用可能になります。

​
/auth/token/get/list API

発行済のアクセストークン一覧を取得するためには /auth/token/get/list API を利用してください。

​
定義

GET /auth/token/get/list?
    clientIdentifier={clientIdentifier}
    &subject={subject}
    &start={start}
    &end={end}

​
リクエスト

パラメーター
パラメーター名必須説明デフォルト値
clientIdentifierNO特定のクライアントに紐づくアクセストークン一覧を取得したい場合はこのパラメーターに対象のクライアントの識別子を指定する。識別子として指定できる値は、クライアント ID あるいはクライアント ID の別名のいずれかである。なし
subjectNO特定のユーザーに紐づくアクセストークン一覧を取得したい場合はこのパラメーターに対象のユーザーの一意識別子を指定する。なし
startNO検索結果の開始インデックス。0
endNO検索結果の終了インデックス。5
(注意) 本 API より返却されるアクセストークンの数 (= end - start の値) は、最大で 20 となっています (パフォーマンス劣化を防ぐため)。したがって、これを超えるようなパラメーター指定はエラーとなりますのでご注意ください。

​
レスポンス

パラメーター
パラメーター名説明
accessTokensアクセストークンのリスト。 返却されるアクセストークンの情報については下記「アクセストークンの情報」を参照のこと。
start検索結果の開始インデックス。
end検索結果の終了インデックス。
totalCount検索条件に該当するアクセストークンの総数。この値は accessTokens の要素数とは異なるので注意すること。
**
アクセストークンの情報 **
パラメーター名説明
accessTokenExpiresAtアクセストークンの有効期限。
accessTokenHashアクセストークンのハッシュ値。
clientIdアクセストークンに紐づけられているクライアントの ID。
createdAtアクセストークンの作成日時。
grantTypeアクセストークン生成時における認可種別。アクセストークンが更新されてもこの値は変更されないことに注意。
lastRefreshedAtアクセストークンが最後にリフレッシュトークンによって更新された日時。
refreshTokenExpiresAtリフレッシュトークンの有効期限。
refreshTokenHashリフレッシュトークンのハッシュ値。
scopesアクセストークンに紐づけられているスコープ群。
subjectアクセストークンに紐づけられているユーザー一意識別子。
**
レスポンス例
** 
{
    "accessTokens": [
        {
            "accessTokenExpiresAt": 1527583747000,
            "accessTokenHash": "kjjduowWXMPiHt1AjxbgkqWANOsVWQfKYCyFO76q1MU",
            "clientId": 11867130158,
            "createdAt": 1527497347000,
            "grantType": "AUTHORIZATION_CODE",
            "lastRefreshedAt": 0,
            "refreshTokenExpiresAt": 1528361347000,
            "refreshTokenHash": "hCkIkuS6py0drpe5XOybw0MxkgsYNOk2q3dtilLiI64",
            "scopes": ["openid"],
            "subject": "john"
        },
        {...},
        {...},
        {...},
        {...}
    ],
    "end": 5,
    "start": 0,
    "totalCount": 15
}