> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/chinese-simplified/shen-fen-yu-fang-wen-guan-li-iam/api-wen-dang-scim/yong-hu-api.md).

# 用户 API

### 概述

该 `/Users` 该端点用于管理系统中的用户身份。

它支持完整的用户生命周期，包括：

* 创建用户
* 检索用户信息
* 更新用户属性
* 删除用户

Okta 和 Microsoft Azure Active Directory 等身份提供商使用此端点进行自动化的预配和取消预配。

***

### 基础端点

```http
https://api.ggwp.com/scim/v2/Users
```

***

### 支持的操作

| 操作   | 方法     | 端点            |
| ---- | ------ | ------------- |
| 创建用户 | POST   | `/Users`      |
| 获取用户 | GET    | `/Users/{id}` |
| 更新用户 | PATCH  | `/Users/{id}` |
| 删除用户 | DELETE | `/Users/{id}` |

***

### 资源标识符

每个用户都通过以下内容唯一标识：

* `id` → 系统生成的唯一标识符
* `userName` → 唯一用户名（由 IdP 使用）
* `email` → 唯一电子邮件地址

***

### 请求和响应格式

所有请求和响应必须：

* 包含 `schemas` 属性
* 遵循 SCIM 2.0 标准

***

### 属性

<table><thead><tr><th width="179.5">属性</th><th>描述</th></tr></thead><tbody><tr><td>id</td><td>唯一标识符</td></tr><tr><td>userName</td><td>唯一用户名</td></tr><tr><td>emails</td><td>用户电子邮件地址</td></tr><tr><td>名称</td><td>用户姓名对象</td></tr><tr><td>active</td><td>表示用户是否处于活动状态（未使用）</td></tr></tbody></table>