确保管理员 Identity

POST /api/v1/forward/identities/admin/ensure 该接口不需要请求体，重复调用返回同一个管理员 Identity。

请求头

Header	是否必填	说明
Authorization	是	`Bearer <PAT 或 SAT>`

示例请求

curl -s -X POST 'https://api.qoder.com/api/v1/forward/identities/admin/ensure' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

HTTP 200 OK

{
  "id": "idn_admin",
  "external_id": "__qca_admin_identity__",
  "name": "QCA Console Admin",
  "identity_type": "admin",
  "enabled": true,
  "metadata": {},
  "created_at": "2026-07-14T10:00:00Z",
  "updated_at": "2026-07-14T10:00:00Z"
}

错误

HTTP	Type	Code	触发条件
401	`authentication_error`	`authentication_required`	PAT 或 SAT 无效、已过期或缺失。
500	`api_error`	-	Identity 创建或查询失败。

备注

管理员 Identity 由系统管理，不能通过普通 Identity 更新、删除、启用或停用接口修改。

​请求头

​示例请求

​示例响应

​错误

​备注

请求头

示例请求

示例响应

错误

备注