根据 ID 获取 Forward Identity。
GET /api/v1/forward/identities/{identity_id}
返回当前账号下的 Identity 详情。
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| identity_id | string | 是 | Forward Identity ID。 |
示例请求
示例响应
HTTP 200 OK
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | Forward Identity ID。 |
| external_id | string | 集成方系统中的终端用户 ID。 |
| name | string | Identity 展示名。 |
| identity_type | string | Identity 类型。普通 Identity 返回 normal。 |
| enabled | boolean | 是否允许继续使用该 Identity。 |
| metadata | object | 业务元数据。 |
| created_at | string | 创建时间，RFC 3339 格式。 |
| updated_at | string | 最近更新时间，RFC 3339 格式。 |
错误
| HTTP | Type | Code | 触发条件 |
|---|---|---|---|
| 404 | not_found_error | - | Identity 不存在或当前调用方不可见。 |
| 401 | authentication_error | authentication_required | PAT 或 SAT 无效或已过期。 |
| 403 | permission_error | - | 当前调用方无权访问该资源。 |
备注
- 已停用的 Identity 仍可查询，但不能执行需要启用状态的操作。
- 已删除的 Identity 不能继续用于创建 Session。