個人トークンの一覧を読む

本人が発行した個人トークンの識別子・範囲・期限・利用状況を返す。値そのものは返さない。

GET/api/me/tokens

Authorization

AuthorizationBearer token · headerrequired

本人用の個人トークン。発行時に選んだ範囲の操作を、本人の名義で行う。読み取りと本人のトークン操作は、範囲を問わず使える。

Responses

200

読めた。

tokensPersonalToken[]required

Show properties

Array of PersonalToken

tokenIdstring

namestring

scopesstring[]

createdAtstring<date-time>

lastUsedAtstring<date-time> | null

expiresAtstring<date-time>

revokedboolean

currentboolean

401

トークンが無いか、この文書を読む権限が無い。

errorstringrequired

エラーの種類を表す短いコード。対処を分けるときはこの値を見る。

statusintegerrequired

HTTP ステータスと同じ値。

currentRevisioninteger

409 comments revision conflict のとき、文書の今の commentsRevision。

latestVersionIdstring

409 stale_target_version のとき、文書の最新版の ID。

Request

curl -X GET 'https://comment-review.fsmarketing.workers.dev/api/me/tokens' \
  -H 'Authorization: Bearer YOUR_TOKEN'

const response = await fetch("https://comment-review.fsmarketing.workers.dev/api/me/tokens", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://comment-review.fsmarketing.workers.dev/api/me/tokens",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "tokens": [
    {
      "tokenId": "pt_example01",
      "name": "string",
      "scopes": [
        "docs"
      ],
      "createdAt": "2019-08-24T14:15:22Z",
      "lastUsedAt": "2019-08-24T14:15:22Z",
      "expiresAt": "2019-08-24T14:15:22Z",
      "revoked": true,
      "current": true
    }
  ]
}

{
  "error": "string",
  "status": 0,
  "currentRevision": 0,
  "latestVersionId": "string"
}