Skip to content
rpicx
⌕ESC

输入关键词，搜索文档与 API

↑↓ 选择↵ 打开ESC 关闭

POST /api/v1/tokens

API 参考/user
POST/api/v1/tokens

创建 API Token

useroperationId: tokenCreate

请求体

请求数据

Content-Type · application/json

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "scopes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "expires_at": {
      "type": "string",
      "format": "date-time"
    }
  }
}

请求示例

cURL
curl -X POST 'http://localhost:8080/api/v1/tokens' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <JWT>'
JavaScript
const res = await fetch('http://localhost:8080/api/v1/tokens', {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer <JWT>'
  },
});
const data = await res.json();
Python
import requests

res = requests.post(
    'http://localhost:8080/api/v1/tokens',
    headers={'Accept': 'application/json', 'Authorization': 'Bearer <JWT>'}
)
print(res.json())

响应

201成功

application/json

{
  "type": "object",
  "description": "通用响应包装",
  "properties": {
    "code": {
      "type": "string",
      "example": "ok"
    },
    "message": {
      "type": "string",
      "example": "ok"
    },
    "data": {}
  }
}
400请求参数错误

application/json

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "example": "not_found"
    },
    "message": {
      "type": "string",
      "example": "资源不存在"
    }
  }
}

在线调试

在线调试
凭证仅保存在当前页面内存中
自定义请求 Header