---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# WSD 사용자 API

# WSD 사용자 API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 04월 28일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 14분

WSD 사용자 API는 할당된 작업 공간 위치, 사무실 출근 일정, 공동 작업자, 과거 및 향후 예약 등 인증된 사용자의 직장 컨텍스트를 반환하는 스크립트된 REST API입니다.
이 WSD 사용자는 (WSD) 예약 제품에 포함 워크플레이스 서비스 제공 되며 모든 관련 사용자 데이터로 예약 예약 환경을 초기화하기 위한 단일 통화 엔트리포인트를 제공합니다. 이 API는 예약(com.sn_wsd_rsv) 플러그인 내에 워크플레이스 서비스 제공 있으며 사용자의 전체 직장 ID 및 이력을 표시하기 위한 엔트리포인트 역할을 합니다.

인증된 사용자는 로그인되어 있거나 자격 증명이 API 요청에 포함된 사용자입니다.  
일반적인 사용 사례:

* 예약 포털 초기화: 직장 앱 또는 포털을 열 때 한 번의 호출로 사용자의 집 위치, 일정 및 예약 내역을 로드합니다.
* 사용자 지정 모바일 또는 웹 앱: 프론트엔드 예약 환경을 빌드하는 경우와 같이 여러 테이블 API 호출을 연결하지 않고 모든 사용자 컨텍스트를 가져옵니다.
* 사무실 내 상태 추적: 지정된 날짜에 사무실에 출근할 예정인 직원을 식별합니다.
{#wsd_user-api__ul_d4s_ns5_bjc}

## 요구 사항 {#wsd_user-api__section_mbl_vw4_bjc}

WSD 사용자 API에는 다음이 필요합니다.

* sn_wsd_core.workplace_user 역할이 있는 사용자 기록이 하나 이상 있어야 합니다.
* 워크플레이스 서비스 제공 컨시어지(com.sn_wsd_concierge워크플레이스 서비스 제공), 코어(com.sn_wsd_core) 및 워크플레이스 서비스 제공 예약(com.sn_wsd_rsv) 플러그인이 활성화됩니다.
{#wsd_user-api__ul_okx_zw4_bjc}

## 관련 API {#wsd_user-api__section_kbb_kt5_bjc}

WSD 사용자 API는 전체 예약 수명주기를 함께 지원하는 `sn_wsd_rsv` 네임스페이스 아래의 API 제품군에 속합니다.

* WSD 검색 API: 위치, 시간 및 용량 기준에 따라 사용 가능한 예약 가능한 공간을 찾습니다.
* WSD 예약 API: 예약을 생성하고 체크인/체크아웃을 관리합니다.
* WSD 예약 가능 모듈 API: 사용자가 예약할 수 있는 항목과 예약 방법을 관리하는 예약 규칙 구성을 검색합니다.
{#wsd_user-api__ul_exw_3t5_bjc}

## WSD 사용자 - GET /api/sn_wsd_rsv/v1/user/context {#ariaid-title2}

할당된 직장 위치, 현재 상태 일정, 공동 작업자, 과거 및 향후 예약 등 인증된 사용자의 직장 컨텍스트를 검색합니다.
이 엔드포인트를 사용하여 단일 호출에 모든 관련 사용자 컨텍스트를 로드하여 예약 환경을 초기화합니다. 공동 작업자 데이터는 com.sn_wsd_concierge 플러그인이 활성화된 경우 선택적으로 포함됩니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/user/context

기본 URL: /api/sn_wsd_rsv/user/context

### 지원되는 요청 매개변수

{#wsd_user-GET-context__entry__2}{#wsd_user-GET-context__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 1. 경로 매개변수]

{#wsd_user-GET-context__entry__6}

| 이름 | 설명 |
|-|-|
| 포함 | 응답에 관련 데이터를 포함하기 위한 값입니다. 엄격한 동일성 일치를 사용합니다(쉼표로 구분된 구문 분석이 아님). 주: include 는 컨시어지(com.sn_wsd_concierge) 플러그인이 워크플레이스 서비스 제공 활성 상태인 경우에만 유효합니다. 유효한 값만: <kbd class="ph userinput">공동 작업자</kbd> 데이터 유형: 문자열 기본값: 응답에서 공동 작업자를 제외합니다. |
| past_reservations_months | 반환할 과거 예약의 개월 수입니다. 데이터 유형: 숫자 최소값: `0` 최대값: `12` 기본값: `3` |
| future_reservations_months | 반환할 향후 예약의 개월 수입니다. 데이터 유형: 숫자 최소값: `0` 최대값: `12` 기본값: `3` |
[표 2. 쿼리 매개변수]

{#wsd_user-GET-context__entry__14}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 3. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_user-GET-context__entry__18}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형: application/json, application/xml, text/xml. |
| 권한 부여 | 인증 자격 증명입니다. 기본 인증 또는 세션 기반 인증을 지원합니다. |
[표 4. 요청 헤더]

{#wsd_user-GET-context__entry__24}

| 머리글 | 설명 |
|-|-|
| 콘텐츠-형식 | 응답 본문의 데이터 형식: application/json. |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_user-GET-context__entry__28}{#wsd_user-GET-context__entry-200-status-code}{#wsd_user-GET-context__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#wsd_user-GET-context__entry__34}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "collaborators": [Array], "reservations": {Object}, "schedule": {Object}, "workplace_location": {Object} } |
| 공동 작업자 | 현재 상태 데이터가 있는 사용자의 공동 작업자 목록입니다. 데이터 유형: 객체 배열 "collaborators": [ { "sys_id": "String", "name": "String", "routine": "Object", "exceptions": "Array" } ] |
| 공동 작업자.예외 | 공동 작업자의 오피스 일정이 루틴에서 벗어나는 날짜 목록입니다. 계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 사용자가 해당 날짜에 사무실에 출근할 계획이면 `true` 를 표시하고 출석이 계획되지 않은 경우에는 `false` 를 표시합니다. 데이터 유형: 객체 배열 "exceptions": [ { "monday": "Boolean", "tuesday": "Boolean", "wednesday": "Boolean", "thursday": "Boolean", "friday": "Boolean", "saturday": "Boolean", "sunday": "Boolean" } ] |
| collaborators.name | 공동 작업자의 표시 이름입니다. 예: <kbd class="ph userinput">Jane Smith</kbd> 데이터 유형: 문자열 |
| collaborators.routine | 공동 작업자의 반복되는 주간 오피스 일정입니다. 와 동일한 요일 부울 구조 schedule.routine를 따릅니다. `예` 값은 오피스 출석을 나타내고 `아니오`는 결석을 나타냅니다. 데이터 유형: 객체 "routine": { "monday": Boolean, "tuesday": Boolean, "wednesday": Boolean, "thursday": Boolean, "friday": Boolean, "saturday": Boolean, "sunday": Boolean } |
| collaborators.sys_id | 공동 작업자의 사용자 기록 Sys_id입니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
| 예약 | 사용자의 과거 및 향후 예약을 포함하는 객체입니다. 개인 및 위치 없는 예약은 제외됩니다. 방향당 최대 100개의 예약이 가능합니다. 상태별로 필터링됨: 확인됨, 완료됨. 데이터 유형: 객체 "reservations": { "past": [Array], "future": [Array] } |
| 예약.미래 | 요청된 월 범위 내 사용자의 향후 예약 목록입니다. 시작 날짜/시간별로 가장 빠른 순서부터 정렬됩니다. 데이터 유형: 객체 배열 "future": [ { "sys_id": "String", "number": "String", "start": "String", "end": "String", "state": "String", "subject": "String, "location": {Object}, "building": {Object} } ] |
| 예약.미래.건물 | 예약 위치가 있는 건물입니다. 데이터 유형: 객체 "building": { "name": "String", "sys_id": "String" } |
| reservations.future.building.name | 건물의 표시 이름입니다. 예를 들어, <kbd class="ph userinput">HQ 빌딩 A</kbd>입니다. 데이터 유형: 문자열 |
| reservations.future.building.sys_id | 건물 기록의 Sys_id입니다. 테이블: 직장 건물 \[sn_wsd_core_building\] 데이터 유형: 문자열 |
| 예약.미래.종료 | 예약의 종료 날짜 시간(UTC)입니다. 형식: yyyy-MM-dd HH:mm:ss 데이터 유형: 문자열 |
| 예약.미래.위치 | 예약 공간입니다. 데이터 유형: 객체 "location": { "sys_id": "String", "name": "String" } |
| reservations.future.location.name | 예약 위치의 표시 이름입니다. 예: <kbd class="ph userinput">Desk 42</kbd> 데이터 유형: 문자열 |
| reservations.future.location.sys_id | 예약 위치의 Sys_id입니다. 테이블: 직장 위치 \[sn_wsd_core_workplace_location\] 데이터 유형: 문자열 |
| 예약.미래.번호 | 사람이 읽을 수 있는 예약 번호입니다. 예를 들면 <kbd class="ph userinput">RSV0001234</kbd>입니다. 데이터 유형: 문자열 |
| reservations.future.start | 예약의 시작 날짜 시간(UTC)입니다. 형식: yyyy-MM-dd HH:mm:ss 데이터 유형: 문자열 |
| reservations.future.state | 예약의 현재 상태입니다. 유효한 값은 다음과 같습니다. * `확인됨` * `완료됨` {#wsd_user-GET-context__ul_hlk_wbv_bjc} 데이터 유형: 문자열 |
| 예약.미래.제목 | 예약의 주제 또는 제목입니다. 예: <kbd class="ph userinput">팀 스탠드업 데스크</kbd> 데이터 유형: 문자열 |
| reservations.future.sys_id | 예약 기록의 Sys_id입니다. 테이블: 직장 예약 \[sn_wsd_rsv_reservation\] 데이터 유형: 문자열 |
| 예약.과거 | 요청된 월 범위 내 사용자의 과거 예약 목록입니다. 시작 날짜/시간별로 정렬되며, 가장 최근 항목부터 정렬됩니다. 와 reservation.future동일한 배열 구조를 따릅니다. 데이터 유형: 객체 배열 "past": [ { "sys_id": "String", "number": "String", "start": "String", "end": "String", "state": "String", "subject": "String, "location": {Object}, "building": {Object} } ] |
| 일정 | 사용자의 오피스 출근 일정(반복되는 주간 루틴 및 예외 포함) 주: com.sn_wsd_concierge 플러그인이 비활성 상태이면 루틴은 null이고 예외는 빈 배열입니다. 데이터 유형: 객체 "schedule": { "exceptions": [Array], "routine": {Object} } |
| 일정.예외 | 사용자의 오피스 일정이 루틴에서 벗어나는 날짜 목록입니다. 데이터 유형: 객체 배열 "exceptions": [ { "sys_id": "sys_id", "date": "String", "in_office": String, "origin": "String", "location": "String" } ] |
| schedule.exceptions.date | 이 예외가 적용되는 날짜(yyyy-MM-dd 형식)입니다. 사용자의 루틴이 재정의되는 날짜입니다. 데이터 유형: 문자열 |
| schedule.exceptions.in_office | 사용자가 이 날짜에 사무실에 출근할 것인지 여부를 나타내는 플래그입니다. 이는 일정에서 해당 요일에 지정하는 모든 것을 무효화합니다. 유효한 값은 다음과 같습니다. * true: 사용자가 사무실에 있습니다. * false: 사용자가 사무실에 있지 않음 {#wsd_user-GET-context__ul_ttw_2zp_bjc} 데이터 유형: 문자열 |
| 일정.예외.위치 | 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. `in_office`이 예인 경우에만 관련이 있습니다`.` 사용자가 원격 근무인 경우 빈 문자열일 수 있습니다. 데이터 유형: 문자열 |
| 일정.예외.원본 | 예외를 생성한 소스입니다. 유효한 값은 다음과 같습니다. * `사용자`: 직원이 수동으로 생성합니다. * `시스템`: 플랫폼에서 자동으로 생성됩니다. * `수동`: 관리자가 생성하거나 사용자를 대신하여 생성합니다. {#wsd_user-GET-context__ul_mzn_kzp_bjc} 데이터 유형: 문자열 |
| schedule.exceptions.sys_id | 예외 기록의 Sys_id입니다. 테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception) 데이터 유형: 문자열 |
| 일정.루틴 | 사용자의 반복되는 주간 오피스 일정입니다. 각 필드는 요일을 나타내는 부울이며 사용자가 해당 날짜에 사무실에 출근하도록 예약되어 있는지 여부를 나타냅니다. `예` 값은 오피스 출석을 나타내고 `아니오`는 결석을 나타냅니다. 데이터 유형: 객체 "routine": { "monday": Boolean, "tuesday": Boolean, "wednesday": Boolean, "thursday": Boolean, "friday": Boolean, "saturday": Boolean, "sunday": Boolean } |
| workplace_location | 사용자에게 할당된 직장 위치(층, 건물 및 캠퍼스 상세 정보 포함) 데이터 유형: 객체 "workplace_location": { "building": {Object}, "campus": {Object}, "floor": {Object}, "name": "String", "sys_id": "String" } |
| workplace_location.건물 | 직장 위치가 있는 건물입니다. 데이터 유형: 객체 "building": { "name": "String", "sys_id": "String" } |
| workplace_location.building.name | 건물의 표시 이름입니다. 예를 들어, <kbd class="ph userinput">HQ 빌딩 A</kbd>입니다. 데이터 유형: 문자열 |
| workplace_location.building.sys_id | 건물 기록의 Sys_id입니다. 테이블: 직장 건물 \[sn_wsd_core_building\] 데이터 유형: 문자열 |
| workplace_location.campus | 건물이 있는 캠퍼스입니다. 데이터 유형: 객체 "campus": { "name": "String", "sys_id": "String" } |
| workplace_location.campus.name | 캠퍼스의 표시 이름입니다. 예: <kbd class="ph userinput">메인 캠퍼스</kbd> 데이터 유형: 문자열 |
| workplace_location.campus.sys_id | 캠퍼스 기록의 Sys_id입니다. 테이블: 직장 캠퍼스 \[sn_wsd_core_campus\] 데이터 유형: 문자열 |
| workplace_location.floor | 직장 위치가 위치한 층입니다. 데이터 유형: 객체 "floor": { "name": "String", "sys_id": "String" } |
| workplace_location.floor.name | 층 기록의 Sys_id입니다. 테이블: 직장 층 \[sn_wsd_core_floor\] 데이터 유형: 문자열 |
| workplace_location.floor.sys_id | 층의 표시 이름입니다. 예를 들어 <kbd class="ph userinput">3층</kbd>입니다. 데이터 유형: 문자열 |
| workplace_location.name | 사용자에게 할당된 직장 위치의 표시 이름입니다. 예: 책 <kbd class="ph userinput">상 42 - 3층</kbd>. 데이터 유형: 문자열 |
| workplace_location.sys_id | 사용자의 할당된 직장 위치의 Sys_id입니다. 테이블: 직장 위치 \[sn_wsd_core_workplace_location\] 데이터 유형: 문자열 |
[ ]

### cURL 요청

다음 예에서는 공동 작업자, 과거 예약 1개월, 향후 예약 6개월을 포함하여 인증된 사용자의 전체 직장 컨텍스트를 검색합니다.

    curl "https://<instance>.service-now.com/api/sn_wsd_rsv/v1/user/context?include=collaborators&past_reservations_months=1&future_reservations_months=6" \
      --request GET \
      --header "Accept: application/json" \
      --user "username:password"

응답 본문.

    {
      "result": {
        "workplace_location": {
          "sys_id": "a1b2c3d4e5f6g7h8",
          "name": "Desk 42 - Floor 3",
          "floor": { "sys_id": "f1a2b3c4", "name": "Floor 3" },
          "building": { "sys_id": "b1c2d3e4", "name": "HQ Building A" },
          "campus": { "sys_id": "c1d2e3f4", "name": "Main Campus" }
        },
        "schedule": {
          "routine": {
            "monday": true, "tuesday": true, "wednesday": false,
            "thursday": true, "friday": false, "saturday": false, "sunday": false
          },
          "exceptions": []
        },
        "collaborators": [
          {
            "sys_id": "d4e5f6g7",
            "name": "Jane Smith",
            "routine": { "monday": true, "tuesday": false, "wednesday": true,
                         "thursday": true, "friday": false, "saturday": false, "sunday": false },
            "exceptions": []
          }
        ],
        "reservations": {
          "past": [
            {
              "sys_id": "r1e2s3v4",
              "number": "RSV0001234",
              "start": "2026-04-01 09:00:00",
              "end": "2026-04-01 17:00:00",
              "state": "completed",
              "subject": "Team standup desk",
              "location": { "sys_id": "l1o2c3", "name": "Desk 42" },
              "building": { "sys_id": "b1c2d3e4", "name": "HQ Building A" }
            }
          ],
          "future": []
        }
      }
    }