Skip to main content
Identities

确保管理员 Identity

获取当前账号的管理员 Identity；如果尚未存在，则创建并返回。

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

请求头

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

示例请求

curl -s -X POST 'https://api.qoder.com.cn/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"
}

错误

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

备注

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