创建控制面 Key

POST/enterprise/control-keys

name（最长 100）和 keyType（MANAGEMENT 或 PROVISIONING）必填。scopes 为允许权限的子集（最多 16）；省略/空列表使用可能含写权限的默认集。监控请显式指定 tenant:billing:read。allowedIps 最多 50 个 IP/CIDR。expiresAt 为未来 ISO-8601 时间，默认 90 天，最长 365 天。apiKey 仅展示一次。

身份验证

企业主账号登录态 JWT；管理 Key、PROVISIONING Key 和推理 Key 不支持。

Authorization: Bearer <USER_JWT>

审批与重试指南

请求体

namestringrequired

Max 100 / 最长 100

keyTypestringrequired

MANAGEMENT | PROVISIONING

scopesstring[]

Allowed subset; max 16 / 允许权限的子集，最多 16

allowedIpsstring[]

Max 50 IP/CIDR / 最多 50 个 IP/CIDR

expiresAtstring

Future ISO-8601; default 90 days, max 365 / 未来 ISO-8601，默认 90 天，最长 365 天

字段使用 camelCase。必填项及可选字段见上文。

JSON

1{
2  "name": "billing-monitor",
3  "keyType": "MANAGEMENT",
4  "scopes": [
5    "tenant:billing:read"
6  ]
7}

响应

HTTP 201; code: 200. 以下为示例值，字段使用 camelCase。

codeinteger

200

dataobject | null

data.apiKeystring

data.credentialobject

错误处理

检查 HTTP 状态和 code，失败时读取 serviceCode、msg、traceId。无效凭证无法读取数据；仅企业主登录态可以操作。跨企业资源不可访问。不要把 202 接受或审批待处理当作业务完成。

请求

Shell

1curl -X POST "https://api.token360.ai/enterprise/control-keys" \
2  -H "Authorization: Bearer $USER_JWT" \
3  -H "Content-Type: application/json" \
4  --data '{"name": "billing-monitor", "keyType": "MANAGEMENT", "scopes": ["tenant:billing:read"]}'

响应

JSON

1{
2  "code": 200,
3  "msg": "success",
4  "data": {
5    "apiKey": "<ONE_TIME_CONTROL_KEY>",
6    "credential": {
7      "hash": "<KEY_HASH>",
8      "name": "service-key",
9      "keyDisplay": "sk-…",
10      "status": "ACTIVE",
11      "allowedIps": [],
12      "expiresAt": null,
13      "createdAt": "2026-11-03T00:00:00Z",
14      "keyType": "MANAGEMENT",
15      "scopes": [
16        "tenant:billing:read"
17      ]
18    }
19  }
20}

此页面对您有帮助吗？