API 参考
Create API Key
创建新的 API Key，并只返回一次明文 Token。
POST
/api/open/v1/keys接口概览
201api_keys:write
创建新的 API Key，并只返回一次明文 Token。
认证方式
请求头使用：
Authorization: Bearer <token>这个接口所需的 scopes：
api_keys:write请求体
name
string必填API Key 名称。
environment
enum<string>默认值: test创建到哪个环境，默认 test。
testlive
scopes
scope[]要授予该 Key 的 scopes；不传时默认只给读取类 scopes。
响应
201 - application/json
object
string固定为 open_api.key.create。
key
object新建后的 Key 信息。
id
stringAPI Key ID。
name
stringAPI Key 名称。
environment
enum<string>所属环境。
testlive
scopes
scope[]当前 Key 具备的 scopes。
status
enum<string>Key 状态。
activerevoked
tokenPrefix
stringToken 前缀。
tokenLast4
stringToken 后四位。
maskedToken
string掩码后的 Token 展示值。
createdAt
string创建时间。
updatedAt
string更新时间。
lastUsedAt
string | null最近使用时间。
lastUsedIp
string | null最近使用 IP。
lastUsedUserAgent
string | null最近使用的 User-Agent。
revokedAt
string | null撤销时间。
token
string新签发的明文 Token，只会返回一次。
常见错误
UNAUTHORIZED
error_code缺少或无效的 Bearer Token。
RATE_LIMITED
error_code当前 Token 触发限流。
NOT_FOUND
error_code当前 API Key 不存在，或已被清理。
说明
- 创建成功后请立即持久化 token。后续只能看到 maskedToken，无法再次读取明文。
这个页面对你有帮助吗？