CLI のログインコードを個人トークンに交換する

CLI がループバックで受け取った一度きりのコードと照合用の値を送り、個人トークンを受け取る。Cookie は使わない。

POST/api/auth/cli/token

Request body

requiredapplication/json

codestringrequired

min length 43 · max length 43

verifierstringrequired

min length 1

Responses

200

個人トークンを発行した。値はこの応答でだけ返る。

tokenstringrequired

個人トークンの値。保存して以後の要求の Bearer 値に使う。

tokenIdstringrequired

namestringrequired

scopesstring[]required

expiresAtstring<date-time>required

userPersonalTokenUserrequired

Show properties

idstring

displayNamestring

emailstring<email> | null

domainstring | null

400

コードが無い・使用済み・期限切れ、または照合の値が違う。

errorstringrequired

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

statusintegerrequired

HTTP ステータスと同じ値。

currentRevisioninteger

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

latestVersionIdstring

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

Request

curl -X POST 'https://comment-review.fsmarketing.workers.dev/api/auth/cli/token' \
  -H 'Content-Type: application/json' \
  -d '{
  "code": "stringstringstringstringstringstringstrings",
  "verifier": "string"
}'

const response = await fetch("https://comment-review.fsmarketing.workers.dev/api/auth/cli/token", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: "{\n  \"code\": \"stringstringstringstringstringstringstrings\",\n  \"verifier\": \"string\"\n}"
});

import requests

response = requests.post(
    "https://comment-review.fsmarketing.workers.dev/api/auth/cli/token",
    headers={
        "Content-Type": "application/json"
    },
    data="{\n  \"code\": \"stringstringstringstringstringstringstrings\",\n  \"verifier\": \"string\"\n}",
)

Response

{
  "token": "string",
  "tokenId": "pt_example01",
  "name": "string",
  "scopes": [
    "docs"
  ],
  "expiresAt": "2019-08-24T14:15:22Z",
  "user": {
    "id": "string",
    "displayName": "string",
    "email": "user@example.com",
    "domain": "string"
  }
}

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