Skip to content

리소스 ID로 기존 대시보드 사용자 계정 조회하기

get

/scim/v2/Users/{id}

이 엔드포인트를 사용하여 SCIM POST 메서드에서 반환된 리소스 id를 지정하여 기존 대시보드 사용자 계정을 조회할 수 있습니다.

See me in Postman

필수 조건

이 엔드포인트를 사용하려면 SCIM 토큰이 필요합니다. 서비스 Origin을 X-Request-Origin 헤더로 사용합니다. 자세한 내용은 자동화된 사용자 프로비저닝을 참조하세요.

사용량 제한

이 엔드포인트는 회사당 일일 20,000건의 요청 제한이 적용됩니다. 이 사용량 제한은 API 사용량 제한에 설명된 대로 /scim/v2/Users/ PUT, GET, DELETE 및 POST 엔드포인트와 공유됩니다.

경로 매개변수

매개변수 필수 데이터 유형 설명
id 필수 문자열 사용자의 리소스 ID입니다. 이 매개변수는 POST /scim/v2/Users/ 또는 GET /scim/v2/Users?filter=userName eq "[email protected]" 메서드에서 반환됩니다.

요청 매개변수

1
2
3

Content-Type: application/json
X-Request-Origin: YOUR-REQUEST-ORIGIN-HERE
Authorization: Bearer YOUR-SCIM-TOKEN-HERE

요청 예시

1
2
3
4

curl --location --request GET 'https://rest.iad-01.braze.com/scim/v2/Users/dfa245b7-24195aec-887bb3ad-602b3340' \
--header 'Content-Type: application/json' \
--header 'X-Request-Origin: YOUR-REQUEST-ORIGIN-HERE' \
--header 'Authorization: Bearer YOUR-SCIM-TOKEN-HERE' \

응답

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
    "id": "dfa245b7-24195aec-887bb3ad-602b3340",
    "userName": "[email protected]",
    "name": {
        "givenName": "Test",
        "familyName": "User"
    },
    "department": "finance",
    "lastSignInAt": "2024 Nov 11, 4:20 PM",
    "createdAt": "2024 Nov 11, 4:20 PM",
    "permissions": {
        "companyPermissions": ["manage_company_settings"],
        "roles": [
            {
                "roleName": "Another Test Role",
                "roleId": "23125dad23dfaae7",
                "appGroup": [
                    {
                        "appGroupId": "241adcd25adfabcded",
                        "appGroupName": "Production Workspace",
                        "appGroupPermissionSets": [
                            {
                                "appGroupPermissionSetName": "A Permission Set",
                                "appGroupPermissionSetId": "dfa385109bc38",
                                "permissions": ["basic_access","publish_cards"]
                            }
                        ]
                    }
                ]
            }
        ],
        "appGroup": [
            {
                "appGroupId": "241adcd25789fabcded",
                "appGroupName": "Test Workspace",
                "appGroupPermissions": ["basic_access","send_campaigns_canvases"],
                "team": [
                    {
                         "teamId": "241adcd25789fabcded",
                         "teamName": "Test Team",
                         "teamPermissions": ["admin"]
                    }
                ]
            }
        ]
    }
}

응답 매개변수

매개변수 데이터 유형 설명
schemas 문자열 배열 SCIM 사용자 스키마입니다.
id 문자열 사용자의 리소스 ID입니다.
userName 문자열 사용자의 이메일 주소입니다.
name 객체 givenName과 familyName을 포함합니다.
department 문자열 설정된 경우 사용자의 부서입니다.
createdAt 문자열 사용자 계정이 생성된 시점입니다. 설정되지 않은 경우 N/A를 반환하며, 그렇지 않으면 YYYY Mon DD, H:MM AM/PM 형식으로 표시됩니다.
lastSignInAt 문자열 사용자가 마지막으로 로그인한 시점입니다. 사용자가 로그인한 적이 없으면 N/A를 반환하며, 그렇지 않으면 YYYY Mon DD, H:MM AM/PM 형식으로 표시됩니다.
permissions 객체 사용자의 회사, 워크스페이스, 팀 및 역할 권한입니다. 권한 객체를 참조하세요.

오류 상태

제공된 리소스 id에 해당하는 사용자가 없는 경우 엔드포인트는 다음을 반환합니다:

1
2
3
4
5
6
7
8

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],
  "status": 404,
  "detail": "Resource not found"
}
New Stuff!