提交控制面操作

POST/enterprise/v1/operations

action、parameters、idempotencyKey 必填，idempotencyKey 最长 128 字符。该接口提交待审批操作；HTTP 202/code 200 不表示执行成功。企业须启用审批，支持的 action 和参数结构见审批指南。

身份验证

控制面 Key；必须具有 action 所需的全部 scope。模型策略操作仅 MANAGEMENT 支持。

Authorization: Bearer <CONTROL_KEY>

审批与重试指南

请求体

actionstringrequired

Supported action name / 支持的 action 名称

parametersobjectrequired

Action-specific parameters / 对应 action 的参数

idempotencyKeystringrequired

Nonblank; max 128 / 非空，最长 128

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

JSON

1{
2  "action": "set_sub_account_status",
3  "parameters": {
4    "subAccountId": "1000000001",
5    "status": "suspended"
6  },
7  "idempotencyKey": "member-pause-001"
8}

响应

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

codeinteger

200

dataobject | null

data.operationIdstring

data.actionstring

data.statusstring

data.executedboolean

data.digeststring

data.parametersobject

data.beforeobject

data.resultstring | null

data.failureCodestring | null

data.approvalPathstring

data.createdAtstring

data.expiresAtstring

错误处理

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

请求

Shell

1curl -X POST "https://api.token360.ai/enterprise/v1/operations" \
2  -H "Authorization: Bearer $CONTROL_KEY" \
3  -H "Content-Type: application/json" \
4  --data '{"action": "set_sub_account_status", "parameters": {"subAccountId": "1000000001", "status": "suspended"}, "idempotencyKey": "member-pause-001"}'

响应

JSON

1{
2  "code": 200,
3  "msg": "success",
4  "data": {
5    "operationId": "00000000-0000-4000-8000-000000000001",
6    "action": "set_sub_account_status",
7    "status": "pending_approval",
8    "executed": false,
9    "digest": "<DIGEST>",
10    "parameters": {
11      "subAccountId": "1000000001",
12      "status": "suspended"
13    },
14    "before": {},
15    "result": null,
16    "failureCode": null,
17    "approvalPath": "<SERVER_RETURNED_APPROVAL_PATH>",
18    "createdAt": "2026-11-03T00:00:00Z",
19    "expiresAt": "2026-11-03T00:15:00Z"
20  }
21}

此页面对您有帮助吗？