POST /api/private/v1/customers/resolve

按客户标识精确解析客户，并返回客户详情。

请求体

{
  "customer": { "type": "external_user_id", "value": "u_1001" }
}

字段	类型	必填	说明
customer.type	string	是	客户标识类型，最大 16 个字符
customer.value	string	是	客户标识值，最大 128 个字符

成功响应

返回结构与 GET /api/private/v1/customers/:customerId 相同，可直接拿到 id 继续调用资源型接口。

{
  "ok": true,
  "requestId": "req_123",
  "data": {
    "id": 1,
    "username": "customer_001",
    "projectId": "clx_project",
    "enabled": true,
    "temporary": false,
    "credentials": [
      { "id": 9, "type": 0, "createdAt": "2026-03-01T00:00:00.000Z" }
    ],
    "identifiers": [
      { "id": 10, "type": "username", "value": "customer_001", "readonly": true },
      { "id": 11, "type": "external_user_id", "value": "u_1001", "readonly": false }
    ],
    "createdAt": "2026-03-01T00:00:00.000Z",
    "updatedAt": "2026-03-21T00:00:00.000Z"
  }
}

可能错误

• 404 CUSTOMER_NOT_FOUND