---
title: "创建API Token"
method: POST
path: "/user/api-tokens"
tags: ["API Token管理"]
---

# 创建API Token

`POST /user/api-tokens`

用户创建自己的API访问令牌

## Request body

- AuthApiTokenCreateRequest
  - `expireDays` integer — 过期天数（0=永久有效）
  - `name` string, required — Token名称
  - `scopes` string[] — 权限范围限制

## Response `200`

创建成功

- object
  - `code` integer
  - `data` AuthApiTokenCreateResponse
    - `expiresAt` string
    - `id` integer
    - `name` string
    - `token` string — 仅在创建时返回完整Token
    - `tokenPrefix` string — Token前缀（用于列表显示）
  - `message` string
  - `msg` string

## Other responses

- `400` — 参数错误
- `500` — 创建失败

---

[API](https://skmtc.net/oneclickvirt/apis/oneclickvirt-api.md) · [All operations](https://skmtc.net/oneclickvirt/apis/oneclickvirt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneclickvirt/oneclickvirt-api/versions/1f98232296de/schema)