创建成员 API Key

POST/enterprise/v1/sub-accounts/{subAccountId}/api-keys

name 必填，最长 100 字符。workspaceCode 默认 DEFAULT。可选 expiresAt 使用 ISO-8601；allowedIps 最多 50 个 IP/CIDR。spendLimit 为正数美元金额，省略表示无 Key 预算限制。limitReset 为 daily、weekly、monthly 或 null（累计）。apiKey 仅返回一次，后续管理使用 credential.hash。

身份验证

MANAGEMENT / PROVISIONING Key；tenant:keys:write

Authorization: Bearer <CONTROL_KEY>

路径中的 subAccountId 必须属于当前企业；hash 是 Key 元数据标识，不能传明文密钥。

审批与重试

启用审批的企业需传 Idempotency-Key，可能返回 HTTP 409 / APPROVAL_REQUIRED，data.operation.executed=false；此时尚未执行，不应当作成功。未启用审批时直接执行；不要假设任意 POST 都支持幂等重试。

审批与重试指南

路径参数

subAccountIdstringrequired

10-digit public member ID / 10 位成员编号

请求体

namestringrequired

At most 100 characters / 最长 100 字符

workspaceCodestring

Default: DEFAULT / 默认 DEFAULT

expiresAtstring

ISO-8601

allowedIpsstring[]

Up to 50 IP/CIDR entries / 最多 50 个 IP/CIDR

spendLimitnumber

USD > 0 / 美元正数

limitResetstring | null

daily | weekly | monthly | null (lifetime / 累计)

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

JSON

1{
2  "name": "service-key",
3  "spendLimit": 100,
4  "limitReset": "monthly"
5}

响应

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

codeinteger

200

dataobject | null

data.apiKeystring

data.credentialobject

错误处理

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

请求

Shell

1curl -X POST "https://api.token360.ai/enterprise/v1/sub-accounts/{subAccountId}/api-keys" \
2  -H "Authorization: Bearer $CONTROL_KEY" \
3  -H "Idempotency-Key: <UNIQUE_INTENT_ID>" \
4  -H "Content-Type: application/json" \
5  --data '{"name": "service-key", "spendLimit": 100, "limitReset": "monthly"}'

响应

JSON

1{
2  "code": 200,
3  "msg": "success",
4  "data": {
5    "apiKey": "<ONE_TIME_API_KEY>",
6    "credential": {
7      "hash": "<KEY_HASH>",
8      "name": "service-key",
9      "keyDisplay": "sk-…",
10      "workspaceCode": "DEFAULT",
11      "status": "ACTIVE",
12      "allowedIps": [],
13      "spendLimit": 100,
14      "limitReset": "monthly",
15      "expiresAt": null,
16      "createdAt": "2026-11-03T00:00:00Z"
17    }
18  }
19}

此页面对您有帮助吗？