> 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/kr/id-iam/api-scim/api-1.md).

# 사용자 API

### 개요

이 `/Users` 엔드포인트는 시스템에서 사용자 ID를 관리하는 데 사용됩니다.

다음을 포함한 전체 사용자 수명 주기를 지원합니다:

* 사용자 생성
* 사용자 정보 조회
* 사용자 속성 업데이트
* 사용자 삭제

Okta 및 Microsoft Azure Active Directory와 같은 ID 제공자는 이 엔드포인트를 자동 프로비저닝 및 디프로비저닝에 사용합니다.

***

### 기본 엔드포인트

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

***

### 지원되는 작업

| 작업     | 메서드    | 엔드포인트         |
| ------ | ------ | ------------- |
| 사용자 생성 | POST   | `/Users`      |
| 사용자 조회 | GET    | `/Users/{id}` |
| 사용자 패치 | PATCH  | `/Users/{id}` |
| 사용자 삭제 | DELETE | `/Users/{id}` |

***

### 리소스 식별자

각 사용자는 다음으로 고유하게 식별됩니다:

* `id` → 시스템에서 생성된 고유 식별자
* `userName` → 고유 사용자 이름(IdP에서 사용됨)
* `이메일` → 고유 이메일

***

### 요청 및 응답 형식

모든 요청과 응답은 다음을 충족해야 합니다:

* 포함해야 합니다 `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>이메일들</td><td>사용자 이메일</td></tr><tr><td>name</td><td>사용자의 이름 객체</td></tr><tr><td>active</td><td>사용자가 활성 상태인지 나타냅니다(사용되지 않음)</td></tr></tbody></table>