---
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월 27일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 56분

WSD 현재 상태 API를 사용하면 사용자는 주간 루틴, 일회성 예외 및 공동 작업자 가시성을 포함하여 사무실 내 현재 상태 일정을 관리할 수 있습니다.
이 API는 직원이 계획된 워크플레이스 서비스 제공 사무실 출석을 동료에게 전달할 수 있도록 하여 (WSD) 컨시어지 경험을 지원합니다. 다음 작업에 이 API를 사용합니다.

* 주간 오피스 루틴, 예약된 예외, 선택적으로 공동 작업자의 현재 상태 정보를 포함하여 인증된 사용자의 전체 현재 상태 데이터를 검색합니다.
* 직원이 반복 일정을 설정할 수 있도록 주간 오피스 루틴을 관리합니다.
* 특정 날짜의 루틴을 재정의하는 일회성 예외를 생성하고 관리합니다.
* 공동 작업자를 보고 관리하여 조정된 오피스 내 계획을 수립할 수 있습니다.
{#wsd_presence-api__ul_ktl_jw4_bjc}

인증된 사용자는 로그인되어 있거나 자격 증명이 API 요청에 포함된 사용자입니다. 순서에 관계없이 엔드포인트를 호출합니다. 각각은 독립적으로 작동합니다.

WSD 현재 상태 API는 sn_wsd_concierge 네임스페이스에 속합니다. 컨시어지 플러그인이 활성 상태인 경우 [WSD 예약 API](https://servicenow-prod.fluidtopics.net/bPD0EODjbeq2IGHET330sQ#wsd_reservation-api "(WSD) 예약 API는 워크플레이스 서비스 제공 직장 예약을 관리하기 위한 엔드포인트를 제공합니다.") `GET /user/context` 엔드포인트는 WSD 현재 상태 API에서 현재 상태 일정 데이터를 반환할 수 있습니다.

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

WSD 현재 상태 API에는 다음이 필요합니다.

* 사용자에게 할당된 sn_wsd_core.workplace_user 역할입니다.
* Core(com.sn_wsd_core) 플러그인이 워크플레이스 서비스 제공 활성화되었습니다.
* sn_wsd_core.workplace_user 역할이 할당된 sys_user에 하나 이상의 사용자 기록이 있어야 합니다.
{#wsd_presence-api__ul_okx_zw4_bjc}

## WSD 현재 상태 - DELETE /api/sn_wsd_concierge/v1/presence/collaborator/{collaborator_id} {#ariaid-title2}

인증된 사용자의 현재 상태 가시성 목록에서 공동 작업자를 제거합니다. 사용자가 더 이상 동료의 사무실 출석을 추적하지 않으려는 경우 이 엔드포인트를 사용합니다.
인증된 사용자는 로그인되어 있거나 자격 증명이 API 요청에 포함된 사용자입니다. 공동 작업자는 sys_id로 식별됩니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_concierge/{api_version}/presence/collaborator/{collaborator_id}

기본 URL: /api/sn_wsd_concierge/presence/collaborator/{collaborator_id}

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

{#wsd_presence-DELETE-collaborator-id__entry__2}{#wsd_presence-DELETE-collaborator-id__version-not_optional-RESTAPI}

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

{#wsd_presence-DELETE-collaborator-id__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 2. 쿼리 매개변수]

{#wsd_presence-DELETE-collaborator-id__entry__12}

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

### 헤더

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

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

{#wsd_presence-DELETE-collaborator-id__entry__22}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. collaborator_id 경로 매개변수가 없거나 잘못되었습니다. |
| 404 | 찾을 수 없습니다. 지정된 공동 작업자를 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

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

{#wsd_presence-DELETE-collaborator-id__entry__36}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "message": "String" } |
| 결과.메시지 | 제거된 공동 작업자 수를 나타내는 확인 메시지입니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

이 예에서는 인증된 사용자의 현재 상태 가시성 목록에서 특정 공동 작업자를 제거합니다.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/collaborator/usr1a2b3c4d5e6" \
    --request DELETE \
    --header "Accept: application/json" \
    --user "username:password"

응답 본문.

    {
      "result": {
        "message": "1 collaborator(s) removed"
      }
    }

## WSD 현재 상태 - DELETE /api/sn_wsd_concierge/v1/presence/exception/{exception_id} {#ariaid-title3}

sys_id로 식별된 특정 현재 상태 예외를 삭제합니다. 사용자가 일회성 재정의를 제거하고 해당 날짜에 대한 정규 주간 루틴으로 되돌리려는 경우 이 엔드포인트를 사용합니다.

### URL 형식

버전 관리된 URL: /api/sn_wsd_concierge/{api_version}/presence/exception/{exception_id}

기본 URL: /api/sn_wsd_concierge/presence/exception/{exception_id}

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

{#wsd_presence-DELETE-exception_id__entry__2}{#wsd_presence-DELETE-exception_id__version-not_optional-RESTAPI}

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

{#wsd_presence-DELETE-exception_id__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 8. 쿼리 매개변수]

{#wsd_presence-DELETE-exception_id__entry__12}

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

### 헤더

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

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

{#wsd_presence-DELETE-exception_id__entry__22}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. exception_id 경로 매개변수가 없거나 잘못되었습니다. |
| 404 | 찾을 수 없습니다. 지정된 예외를 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 12. 상태 코드]

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

{#wsd_presence-DELETE-exception_id__entry__36}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "message": "String" } |
| 결과.메시지 | 예외가 삭제되었음을 알리는 확인 메시지입니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

이 예제에서는 예외 exc1a2b3c4d5e6을 삭제하여 해당 날짜를 사용자의 정규 주간 루틴으로 되돌립니다.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/exception/exc1a2b3c4d5e6" \
    --request DELETE \
    --header "Accept: application/json" \
    --user "username:password"

응답 본문.

    {
      "result": {
        "message": "Exception deleted successfully"
      }
    }

## WSD 현재 상태 - GET /api/sn_wsd_concierge/v1/presence/collaborator {#ariaid-title4}

각 공동 작업자의 현재 상태 데이터, 루틴 및 예외와 함께 인증된 사용자의 공동 작업자 목록을 검색합니다. 이 엔드포인트를 사용하면 동료의 사무실 출근 일정을 볼 수 있으므로 조정된 오피스 내 계획을 수립할 수 있습니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_concierge/{api_version}/presence/collaborator

기본 URL: /api/sn_wsd_concierge/presence/collaborator

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

{#wsd_presence-GET-collaborator__entry__2}{#wsd_presence-GET-collaborator__version-not_optional-RESTAPI}

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

{#wsd_presence-GET-collaborator__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 14. 쿼리 매개변수]

{#wsd_presence-GET-collaborator__entry__10}

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

### 헤더

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

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

{#wsd_presence-GET-collaborator__table_a35_235_bjc} {#wsd_presence-GET-collaborator__table_f5p_f35_bjc__entry__2}

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

{#wsd_presence-GET-collaborator__table_f5p_f35_bjc}

### 상태 코드

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

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

{#wsd_presence-GET-collaborator__table_twp_g35_bjc}

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

{#wsd_presence-GET-collaborator__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "count": Number, "collaborators": [Array] } |
| 결과.카운트 | 반환된 총 공동 작업자 수입니다. 데이터 유형: 숫자 |
| 결과.공동 작업자 | 현재 상태 데이터가 있는 공동 작업자 목록입니다. 공동 작업자의 개인정보 보호가 활성화된 경우 privacy_enabled null routine 이고 비어 있는 exceptions경우 예입니다. 데이터 유형: 객체 배열 "collaborators": [ { "sys_id": "String", "name": "String", "privacy_enabled": Boolean, "routine": {Object}, "exceptions": [Array] } ] |
| result.collaborators.sys_id | 공동 작업자의 사용자 기록 Sys_id입니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
| result.collaborators.name | sys_user 기록에 표시되는 공동 작업자의 표시 이름입니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
| result.collaborators.privacy_enabled | 부울입니다. 공동 작업자가 현재 상태 데이터에 대한 개인정보 보호를 활성화했는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * `true`: 공동 작업자의 루틴과 예외가 숨겨집니다. routine 은(는) `null` 이고 exceptions 빈 배열이 됩니다. * `false`: 공동 작업자의 현재 상태 데이터가 표시됩니다. {#wsd_presence-GET-collaborator__ul_w4x_k1q_bjc} 데이터 유형: 부울 |
| 결과.공동 작업자.루틴 | 공동 작업자의 주간 오피스 루틴입니다. 계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 공동 작업자가 해당 날짜에 사무실에 출근할 계획이면 `true` 를 표시하고, 출석이 계획되지 않은 경우에는 `false` 를 표시합니다. 데이터 유형: 객체 "routine": { "monday": "Boolean", "tuesday": "Boolean", "wednesday": "Boolean", "thursday": "Boolean", "friday": "Boolean", "saturday": "Boolean", "sunday": "Boolean" } |
| 결과.공동 작업자.예외 | 공동 작업자의 일회성 현재 상태 예외입니다. 예`일 경우` 빈 배열`privacy_enabled` 반환합니다. 데이터 유형: 객체 배열 "exceptions": [ { "sys_id": "String", "date": "String", "in_office": "Boolean", "origin": "String", "location": "String" } ] |
| result.collaborators.exceptions.sys_id | 예외 기록의 Sys_id입니다. 테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception) 데이터 유형: 문자열 |
| result.collaborators.exceptions.date | 이 예외가 적용되는 날짜입니다. 사용자의 루틴이 재정의되는 날짜입니다. 형식: yyyy-MM-dd 데이터 유형: 문자열 |
| result.collaborators.exceptions.in_office | 사용자가 이 날짜에 사무실에 출근할 것인지 여부를 나타내는 플래그입니다. 이는 해당 요일에 주별 루틴이 지정하는 모든 것을 무효화합니다. 유효한 값은 다음과 같습니다. * `true`: 사용자가 사무실에 있습니다. * `false`: 사용자가 사무실에 있지 않음 {#wsd_presence-GET-collaborator__ul_ttw_2zp_bjc} 데이터 유형: 문자열 |
| result.collaborators.exceptions.origin | 예외를 생성한 소스입니다. 유효한 값은 다음과 같습니다. * `사용자`: 직원이 수동으로 생성합니다. * `시스템`: 플랫폼에서 자동으로 생성됩니다. * `수동`: 관리자가 생성하거나 사용자를 대신하여 생성합니다. {#wsd_presence-GET-collaborator__ul_mzn_kzp_bjc} 데이터 유형: 문자열 |
| 결과.공동 작업자.예외.위치 | 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. `in_office`이 예인 경우에만 관련이 있습니다`.` 사용자가 원격 근무인 경우 빈 문자열일 수 있습니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

이 예에서는 인증된 사용자에 대한 모든 공동 작업자와 해당 공동 작업자의 현재 상태 데이터를 검색합니다.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/collaborator" \
    --request GET \
    --header "Accept: application/json" \
    --user "username:password"

응답 본문.

    {
      "result": {
        "count": 2,
        "collaborators": [
          {
            "sys_id": "usr1a2b3c4d5e6", "name": "Jane Smith", "privacy_enabled": false,
            "routine": {
              "monday": true, "tuesday": true, "wednesday": false,
              "thursday": true, "friday": false, "saturday": false, "sunday": false
            },
            "exceptions": [
              { "sys_id": "exc1a2b3c", "date": "2026-03-10", "in_office": true, "origin": "user", "location": "Building B" }
            ]
          },
          { "sys_id": "usr7f8g9h0i1j2", "name": "John Doe", "privacy_enabled": true, "routine": null, "exceptions": [] }
        ]
      }
    }

## WSD 현재 상태 - GET /api/sn_wsd_concierge/v1/presence/exception {#ariaid-title5}

인증된 사용자의 현재 상태 예외를 검색합니다. 예외는 날짜 범위 또는 특정 예외 sys_id별로 필터링할 수 있습니다. 사용자의 주간 루틴에 대한 일회성 재정의를 보려는 경우 이 엔드포인트를 사용합니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_concierge/{api_version}/presence/exception

기본 URL: /api/sn_wsd_concierge/presence/exception

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

{#wsd_presence-GET-exception__entry__2}{#wsd_presence-GET-exception__version-not_optional-RESTAPI}

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

{#wsd_presence-GET-exception__entry__6}

| 이름 | 설명 |
|-|-|
| exception_id | 검색할 특정 예외의 Sys_id입니다. 제공된 경우 날짜 범위 필터를 재정의하고 일치하는 예외만 반환합니다. 테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception) 데이터 유형: 문자열 |
| exception_start_date | 예외 필터링의 시작 날짜입니다. 형식: yyyy-MM-dd 데이터 유형: 문자열 기본값: 오늘 |
| exception_end_date | 예외 필터링의 종료 날짜입니다. 형식: yyyy-MM-dd 데이터 유형: 문자열 기본값: 오늘 +3개월 |
[표 20. 쿼리 매개변수]

{#wsd_presence-GET-exception__entry__14}

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

### 헤더 {#wsd_presence-GET-exception__section_egz_s35_bjc}

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

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

{#wsd_presence-GET-exception__table_a35_235_bjc} {#wsd_presence-GET-exception__table_f5p_f35_bjc__entry__2}

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

{#wsd_presence-GET-exception__table_f5p_f35_bjc}

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. exception_start_date 또는 exception_end_date에 대한 잘못된 날짜 형식입니다. |
| 404 | 찾을 수 없습니다. 지정된 예외를 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 24. 상태 코드]

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

{#wsd_presence-GET-exception__entry__38}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "exceptions": [Array] } |
| 결과.예외 | 필터 기준과 일치하는 현재 상태 예외 목록입니다. 데이터 유형: 객체 배열 "exceptions": [ { "sys_id": "sys_id", "date": "String", "in_office": String, "origin": "String", "location": "String" } ] |
| result.exceptions.date | 이 예외가 적용되는 날짜입니다. 사용자의 루틴이 재정의되는 날짜입니다. 형식: yyyy-MM-dd 형식 데이터 유형: 문자열 |
| result.exceptions.in_office | 사용자가 이 날짜에 사무실에 출근할 것인지 여부를 나타내는 플래그입니다. 이는 해당 요일에 주별 루틴이 지정하는 모든 것을 무효화합니다. 유효한 값은 다음과 같습니다. * `true`: 사용자가 사무실에 있습니다. * `false`: 사용자가 사무실에 있지 않음 {#wsd_presence-GET-exception__ul_ttw_2zp_bjc} 데이터 유형: 문자열 |
| 결과.예외.위치 | 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. `in_office`이 예인 경우에만 관련이 있습니다`.` 사용자가 원격 근무인 경우 빈 문자열일 수 있습니다. 데이터 유형: 문자열 |
| 결과.예외.원본 | 예외를 생성한 소스입니다. 유효한 값은 다음과 같습니다. * `사용자`: 직원이 수동으로 생성합니다. * `시스템`: 플랫폼에서 자동으로 생성됩니다. * `수동`: 관리자가 생성하거나 사용자를 대신하여 생성합니다. {#wsd_presence-GET-exception__ul_mzn_kzp_bjc} 데이터 유형: 문자열 |
| result.exceptions.sys_id | 예외 기록의 Sys_id입니다. 테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception) 데이터 유형: 문자열 |
[ ]

### cURL 요청

이 예에서는 2026년 상반기의 모든 예외를 검색합니다.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/exception?exception_start_date=2026-01-01&exception_end_date=2026-06-30" \
    --request GET \
    --header "Accept: application/json" \
    --user "username:password"

응답 본문.

    {
      "result": {
        "exceptions": [
          { "sys_id": "exc1a2b3c4d5e6", "date": "2026-02-14", "in_office": true, "origin": "user", "location": "Building A" },
          { "sys_id": "exc7f8g9h0i1j2", "date": "2026-03-17", "in_office": false, "origin": "system", "location": "" }
        ]
      }
    }

## WSD 현재 상태 - GET /api/sn_wsd_concierge/v1/presence {#ariaid-title6}

주간 오피스 루틴, 예약된 현재 상태 예외, 선택적으로 공동 작업자의 현재 상태 정보를 포함하여 인증된 사용자의 전체 현재 상태 데이터를 검색합니다.
이 엔드포인트를 사용하여 사용자의 계획된 사무실 출석에 대한 전체 뷰를 가져올 수 있습니다. 개인정보 설정에 따라 sys_id 제공하여 다른 사용자의 현재 상태 데이터를 쿼리할 수도 있습니다.

### URL 형식

버전 관리 URL: /api/sn_wsd_concierge/{api_version}/presence

기본 URL: /api/sn_wsd_concierge/presence

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

{#wsd_presence-GET-presence__entry__2}{#wsd_presence-GET-presence__version-not_optional-RESTAPI}

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

{#wsd_presence-GET-presence__entry__6}

| 이름 | 설명 |
|-|-|
| user_id | 현재 상태 데이터를 검색할 대상 사용자의 Sys_id입니다. 제공되지 않은 경우 인증된 사용자의 현재 상태 데이터를 반환합니다. 주: 사용자 간 쿼리는 호출자에게 명시적 허가가 없는 경우 401 Unauthortion을 반환합니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
| exception_start_date | 현재 상태 예외를 필터링하는 시작 날짜입니다. 형식: yyyy-MM-dd 데이터 유형: 문자열 기본값: 오늘 |
| exception_end_date | 현재 상태 예외를 필터링하기 위한 종료 날짜입니다. 형식: yyyy-MM-dd 데이터 유형: 문자열 기본값: 오늘 + 3개월 |
| 포함 | 응답에 포함할 관련 데이터입니다. 유효한 값만: <kbd class="ph userinput">공동 작업자</kbd> 데이터 유형: 문자열 |
[표 26. 쿼리 매개변수]

{#wsd_presence-GET-presence__entry__16}

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

### 헤더

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

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

{#wsd_presence-GET-presence__entry__26}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. exception_start_date 또는 exception_end_date의 날짜 형식이 잘못되었거나 user_id 형식이 잘못되었습니다. |
| 401 | 권한이 해제되었습니다. 인증된 사용자에게 대상 사용자의 현재 상태 데이터를 볼 수 있는 권한이 없습니다. user_id가 제공되고 인증된 사용자와 일치하지 않는 경우 반환됩니다. |
| 404 | 찾을 수 없습니다. 지정된 사용자를 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. |
[표 30. 상태 코드]

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

{#wsd_presence-GET-presence__entry__42}

| 이름 | 설명 |
|-|-|
| 결과 | 응답의 결과를 포함하는 객체입니다. "result": { "routine": {Object}, "exceptions": [Array], "collaborators": [Array] } |
| 결과.루틴 | 사용자의 주간 오피스 루틴입니다. 계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 인증된 사용자가 해당 날짜에 사무실에 출근할 계획이면 `true` 를 표시하고 출석이 계획되지 않은 경우에는 `false` 를 표시합니다. 데이터 유형: 객체 "routine": { "monday": "Boolean", "tuesday": "Boolean", "wednesday": "Boolean", "thursday": "Boolean", "friday": "Boolean", "saturday": "Boolean", "sunday": "Boolean" } |
| 결과.예외 | 특정 날짜에 대한 사용자의 루틴을 재정의하는 일회성 현재 상태 예외 목록입니다. 데이터 유형: 객체 배열 "exceptions": [ { "sys_id": "String", "date": "String", "in_office": "Boolean", "origin": "String", "location": "String" } ] |
| result.exceptions.sys_id | 예외 기록의 Sys_id입니다. 테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception) 데이터 유형: 문자열 |
| result.exceptions.date | 이 예외가 적용되는 날짜(yyyy-MM-dd 형식)입니다. 사용자의 루틴이 재정의되는 날짜입니다. 데이터 유형: 문자열 |
| result.exceptions.in_office | 사용자가 이 날짜에 사무실에 출근할 것인지 여부를 나타내는 플래그입니다. 이는 해당 요일에 주별 루틴이 지정하는 모든 것을 무효화합니다. 유효한 값은 다음과 같습니다. * `true`: 사용자가 사무실에 있습니다. * `false`: 사용자가 사무실에 있지 않음 {#wsd_presence-GET-presence__ul_ttw_2zp_bjc} 데이터 유형: 문자열 |
| 결과.예외.원본 | 예외를 생성한 소스입니다. 유효한 값은 다음과 같습니다. * `사용자`: 직원이 수동으로 생성합니다. * `시스템`: 플랫폼에서 자동으로 생성됩니다. * `수동`: 관리자가 생성하거나 사용자를 대신하여 생성합니다. {#wsd_presence-GET-presence__ul_mzn_kzp_bjc} 데이터 유형: 문자열 |
| 결과.예외.위치 | 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. `in_office`이 예인 경우에만 관련이 있습니다`.` 사용자가 원격 근무인 경우 빈 문자열일 수 있습니다. 데이터 유형: 문자열 |
| 결과.공동 작업자 | 공동 작업자 목록 및 해당 현재 상태 데이터입니다. `include=collaborators`가 지정된 경우에만 반환됩니다. 공동 작업자의 개인정보 보호가 활성화된 경우 privacy_enabled null routine 이고 비어 있는 exceptions경우 예입니다. 데이터 유형: 객체 배열 "collaborators": [ { "sys_id": "String", "name": "String", "privacy_enabled": Boolean, "routine": {Object}, "exceptions": [Array] } ] |
| result.collaborators.sys_id | 공동 작업자의 사용자 기록 Sys_id입니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
| result.collaborators.name | sys_user 기록에 표시되는 공동 작업자의 표시 이름입니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
| result.collaborators.privacy_enabled | 부울입니다. 공동 작업자가 현재 상태 데이터에 대한 개인정보 보호를 활성화했는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * `true`: 공동 작업자의 루틴과 예외가 숨겨집니다. routine 은(는) `null` 이고 exceptions 빈 배열이 됩니다. * `false`: 공동 작업자의 현재 상태 데이터가 표시됩니다. {#wsd_presence-GET-presence__ul_w4x_k1q_bjc} 데이터 유형: 부울 |
| 결과.공동 작업자.루틴 | 공동 작업자의 주간 오피스 루틴입니다. 계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 공동 작업자가 해당 날짜에 사무실에 출근할 계획이라면 `true` 로 표시하고, 출석이 계획되지 않았다면 `false` 로 표시합니다. 데이터 유형: 객체 "routine": { "monday": "Boolean", "tuesday": "Boolean", "wednesday": "Boolean", "thursday": "Boolean", "friday": "Boolean", "saturday": "Boolean", "sunday": "Boolean" } |
| 결과.공동 작업자.예외 | 공동 작업자의 일회성 현재 상태 예외입니다. 인증된 사용자의 exceptions 매개변수와 동일한 구조를 따릅니다. 예`일 경우` 빈 배열`privacy_enabled` 반환합니다. 데이터 유형: 객체 배열 "exceptions": [ { "sys_id": "String", "date": "String", "in_office": "Boolean", "origin": "String", "location": "String" } ] |
[ ]

### cURL 요청

이 예에서는 2026년 1분기의 예외에 대해 공동 작업자 일정을 포함하여 인증된 사용자의 전체 현재 상태 데이터를 검색합니다.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence?include=collaborators&exception_start_date=2026-01-01&exception_end_date=2026-03-31" \
    --request GET \
    --header "Accept: application/json" \
    --user "username:password"

응답 본문.

    {
      "result": {
        "routine": {
          "monday": true,  "tuesday": false, "wednesday": true,
          "thursday": true, "friday": false, "saturday": false, "sunday": false
        },
        "exceptions": [
          {
            "sys_id": "a1b2c3d4e5f6",
            "date": "2026-02-14",
            "in_office": true,
            "origin": "user",
            "location": "Building A"
          }
        ],
        "collaborators": [
          {
            "sys_id": "f6e5d4c3b2a1",
            "name": "Jane Smith",
            "privacy_enabled": false,
            "routine": {
              "monday": true, "tuesday": true, "wednesday": false,
              "thursday": true, "friday": false, "saturday": false, "sunday": false
            },
            "exceptions": []
          }
        ]
      }
    }

## WSD 현재 상태 - GET /api/sn_wsd_concierge/v1/presence/routine {#ariaid-title7}

인증된 사용자의 주간 오피스 루틴만 검색합니다. 이는 예외나 공동 작업자 없이 일상적인 일정만 필요한 경우 GET /presence에 대한 간단한 대안입니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_concierge/{api_version}/presence/routine

기본 URL: /api/sn_wsd_concierge/presence/routine

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

{#wsd_presence-GET-routine__entry__2}{#wsd_presence-GET-routine__version-not_optional-RESTAPI}

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

{#wsd_presence-GET-routine__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 32. 쿼리 매개변수]

{#wsd_presence-GET-routine__entry__10}

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

### 헤더 {#wsd_presence-GET-routine__section_zlj_rj5_bjc}

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

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

{#wsd_presence-GET-routine__table_amj_rj5_bjc} {#wsd_presence-GET-routine__table_bmj_rj5_bjc__entry__2}

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

{#wsd_presence-GET-routine__table_bmj_rj5_bjc}

### 상태 코드

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

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

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

{#wsd_presence-GET-routine__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "user_id": "String", "routine": {Object} } |
| result.user_id | 루틴이 반환되는 사용자의 Sys_id입니다. 테이블: 사용자 \[sys_id\] 데이터 유형: 문자열 |
| 결과.루틴 | 사용자의 반복되는 주간 오피스 일정입니다. 계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 사용자가 해당 날짜에 사무실에 출근할 계획이면 `true` 를 표시하고 출석이 계획되지 않은 경우에는 `false` 를 표시합니다. 데이터 유형: 객체 "routine": { "monday": Boolean, "tuesday": Boolean, "wednesday": Boolean, "thursday": Boolean, "friday": Boolean, "saturday": Boolean, "sunday": Boolean } |
[ ]

### cURL 요청

이 예에서는 인증된 사용자의 주간 오피스 루틴을 검색합니다.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/routine" \
    --request GET \
    --header "Accept: application/json" \
    --user "username:password"

응답 본문. 사용자의 루틴에 월요일부터 목요일까지의 오피스 출석이 표시되는지 보여줍니다.

    {
      "result": {
        "user_id": "a1b2c3d4e5f6g7h8",
        "routine": {
          "monday": true,  "tuesday": true,  "wednesday": true,
          "thursday": true, "friday": false, "saturday": false, "sunday": false
        }
      }
    }

## WSD 현재 상태 - PATCH /api/sn_wsd_concierge/v1/presence/routine {#ariaid-title8}

인증된 사용자의 주간 오피스 루틴을 부분적으로 업데이트합니다. 사용자가 전체 일정을 재설정하지 않고 특정 요일을 조정해야 하는 경우 이 엔드포인트를 사용합니다.
요청 본문에 제공된 날짜만 업데이트됩니다. 나머지 날짜는 모두 변경되지 않습니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_concierge/{api_version}/presence/routine

기본 URL: /api/sn_wsd_concierge/presence/routine

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

{#wsd_presence-PATCH-routine__entry__2}{#wsd_presence-PATCH-routine__version-not_optional-RESTAPI}

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

{#wsd_presence-PATCH-routine__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 38. 쿼리 매개변수]

{#wsd_presence-PATCH-routine__entry__10}

| 이름 | 설명 |
|-|-|
| 루틴 | 필수 인증된 사용자의 주간 루틴입니다. 계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 인증된 사용자가 해당 날짜에 사무실에 출근할 계획이면 `true` 를 표시하고 출석이 계획되지 않은 경우에는 `false` 를 표시합니다. 요청에서 생략된 날짜는 변경되지 않습니다. 빈 루틴 객체는 no-op으로 허용됩니다. 데이터 유형: 객체 "routine": { "monday": "Boolean", "tuesday": "Boolean", "wednesday": "Boolean", "thursday": "Boolean", "friday": "Boolean", "saturday": "Boolean", "sunday": "Boolean" } |
[표 39. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더 {#wsd_presence-PATCH-routine__section_zlj_rj5_bjc}

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

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

{#wsd_presence-PATCH-routine__table_amj_rj5_bjc} {#wsd_presence-PATCH-routine__table_bmj_rj5_bjc__entry__2}

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

{#wsd_presence-PATCH-routine__table_bmj_rj5_bjc}

### 상태 코드 {#wsd_presence-PATCH-routine__section_cjt_dk5_bjc}

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 요청 본문이 누락되었거나, 형식이 잘못되었거나, 유효한 날짜 필드가 제공되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 42. 상태 코드]

{#wsd_presence-PATCH-routine__table_djt_dk5_bjc}

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

{#wsd_presence-PATCH-routine__entry__34}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "message": "String", "result": {Object} } |
| 결과.메시지 | 루틴이 업데이트되었음을 알리는 확인 메시지입니다. 데이터 유형: 문자열 |
| 결과.결과 | 변경되지 않은 날짜를 포함하여 7일 모두가 포함된 완전히 업데이트된 루틴 객체를 포함합니다. 데이터 유형: 객체 "result": { "routine": {Object} } |
| 결과.루틴 | 매주 오피스 루틴입니다. 각 요일에 대한 부울 플래그를 포함합니다. `여기서 예는` 오피스 출근을 나타내고 `아니오` 는 결석을 나타냅니다. 데이터 유형: 객체 "routine": { "monday": "Boolean", "tuesday": "Boolean", "wednesday": "Boolean", "thursday": "Boolean", "friday": "Boolean", "saturday": "Boolean", "sunday": "Boolean" } |
[ ]

### cURL 요청

이 예시에서는 금요일과 토요일만 true로 업데이트하고 나머지 날짜는 모두 변경하지 않고 유지합니다.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/routine" \
    --request PATCH \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --user "username:password" \
    --data '{
      "routine": { "friday": true, "saturday": true }
    }'

응답 본문.

    {
      "result": {
        "message": "Routine updated successfully",
        "result": {
          "routine": {
            "monday": true, "tuesday": true, "wednesday": true,
            "thursday": true, "friday": true, "saturday": true, "sunday": false
          }
        }
      }
    }

## WSD 현재 상태 - POST /api/sn_wsd_concierge/v1/presence/collaborator {#ariaid-title9}

인증된 사용자의 현재 상태 가시성 목록에 한 명 이상의 공동 작업자를 추가합니다. 그러면 공동 작업자가 서로의 현재 상태 데이터를 볼 수 있습니다. 이 엔드포인트를 사용하여 사무실 출석을 추적하려는 팀 또는 동료 그룹을 구성합니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_concierge/{api_version}/presence/collaborator

기본 URL: /api/sn_wsd_concierge/presence/collaborator

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

{#wsd_presence-POST-collaborator__entry__2}{#wsd_presence-POST-collaborator__version-not_optional-RESTAPI}

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

{#wsd_presence-POST-collaborator__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 44. 쿼리 매개변수]

{#wsd_presence-POST-collaborator__entry__10}

| 이름 | 설명 |
|-|-|
| collaborator_ids | 필수 공동 작업자로 추가할 사용자를 식별하는 비어 있지 않은 sys_id 값 배열입니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 배열 "collaborator_ids": ["String", "String"] |
[표 45. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더 {#wsd_presence-POST-collaborator__section_zlj_rj5_bjc}

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

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

{#wsd_presence-POST-collaborator__table_amj_rj5_bjc} {#wsd_presence-POST-collaborator__table_bmj_rj5_bjc__entry__2}

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

{#wsd_presence-POST-collaborator__table_bmj_rj5_bjc}

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. collaborator_ids 누락되었거나 배열이 비어 있거나 sys_id 형식이 잘못되었습니다. |
| 404 | 찾을 수 없습니다. sys_user 테이블에서 하나 이상의 공동 작업자 sys_ids를 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 48. 상태 코드]

{#wsd_presence-POST-collaborator__table_djt_dk5_bjc}

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

{#wsd_presence-POST-collaborator__entry__36}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. 데이터 유형: 객체 result": { "message": "String", "collaborators": [Array] } |
| 결과.메시지 | 공동 작업자가 추가되었음을 나타내는 확인 메시지입니다. 데이터 유형: 문자열 |
| 결과.공동 작업자 | 새로 추가된 공동 작업자 목록과 현재 상태 데이터. 데이터 유형: 객체 배열 "collaborators": [ { "sys_id": "String", "name": "String", "privacy_enabled": Boolean, "routine": {Object}, "exceptions": [Array] } ] |
| result.collaborators.sys_id | 공동 작업자의 사용자 기록 Sys_id입니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
| result.collaborators.name | sys_user 기록에 표시되는 공동 작업자의 표시 이름입니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
| result.collaborators.privacy_enabled | 부울입니다. 공동 작업자가 현재 상태 데이터에 대한 개인정보 보호를 활성화했는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 공동 작업자의 루틴과 예외가 숨겨집니다. routine 은(는) `null` 이고 exceptions 빈 배열이 됩니다. * false: 공동 작업자의 현재 상태 데이터가 표시됩니다. {#wsd_presence-POST-collaborator__ul_w4x_k1q_bjc} 데이터 유형: 부울 |
| 결과.공동 작업자.루틴 | 공동 작업자의 주간 오피스 루틴입니다. 계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 공동 작업자가 해당 날짜에 사무실에 출근할 계획이라면 `true` 로 표시하고, 출석이 계획되지 않았다면 `false` 로 표시합니다. 데이터 유형: 객체 "routine": { "monday": "Boolean", "tuesday": "Boolean", "wednesday": "Boolean", "thursday": "Boolean", "friday": "Boolean", "saturday": "Boolean", "sunday": "Boolean" } |
| 결과.공동 작업자.예외 | 공동 작업자의 일회성 현재 상태 예외입니다. 예`일 경우` 빈 배열`privacy_enabled` 반환합니다. 데이터 유형: 객체 배열 "exceptions": [ { "sys_id": "String", "date": "String", "in_office": "Boolean", "origin": "String", "location": "String" } ] |
| result.collaborators.exceptions.sys_id | 예외 기록의 Sys_id입니다. 테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception) 데이터 유형: 문자열 |
| result.collaborators.exceptions.date | 이 예외가 적용되는 날짜입니다. 사용자의 루틴이 재정의되는 날짜입니다. 형식: yyyy-MM-dd 형식 데이터 유형: 문자열 |
| result.collaborators.exceptions.in_office | 사용자가 이 날짜에 사무실에 출근할 것인지 여부를 나타내는 플래그입니다. 이는 해당 요일에 주별 루틴이 지정하는 모든 것을 무효화합니다. 유효한 값은 다음과 같습니다. * `true`: 사용자가 사무실에 있습니다. * `false`: 사용자가 사무실에 있지 않음 {#wsd_presence-POST-collaborator__ul_ttw_2zp_bjc} 데이터 유형: 문자열 |
| result.collaborators.exceptions.origin | 예외를 생성한 소스입니다. 유효한 값은 다음과 같습니다. * `사용자`: 직원이 수동으로 생성합니다. * `시스템`: 플랫폼에서 자동으로 생성됩니다. * `수동`: 관리자가 생성하거나 사용자를 대신하여 생성합니다. {#wsd_presence-POST-collaborator__ul_mzn_kzp_bjc} 데이터 유형: 문자열 |
| 결과.공동 작업자.예외.위치 | 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. `in_office`이 예인 경우에만 관련이 있습니다`.` 사용자가 원격 근무인 경우 빈 문자열일 수 있습니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

이 예에서는 두 명의 사용자를 sys_ids 제공하여 공동 작업자로 추가합니다.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/collaborator" \
    --request POST \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --user "username:password" \
    --data '{
      "collaborator_ids": ["usr1a2b3c4d5e6", "usr7f8g9h0i1j2"]
    }'

응답 본문.

    {
      "result": {
        "message": "Collaborator(s) added successfully",
        "collaborators": [
          {
            "sys_id": "usr1a2b3c4d5e6", "name": "Jane Smith", "privacy_enabled": false,
            "routine": { "monday": true, "tuesday": true, "wednesday": false, "thursday": true, "friday": false, "saturday": false, "sunday": false },
            "exceptions": []
          },
          { "sys_id": "usr7f8g9h0i1j2", "name": "John Doe", "privacy_enabled": true, "routine": null, "exceptions": [] }
        ]
      }
    }

## WSD 현재 상태 - POST /api/sn_wsd_concierge/v1/presence/exception {#ariaid-title10}

특정 날짜에 인증된 사용자에 대한 일회성 현재 상태 예외를 생성합니다. 사용자가 일반적으로 원격으로 근무하는 날에 사무실에 출근할 계획이거나 그 반대로 계획할 때 이 엔드포인트를 사용합니다.
예외는 해당 날짜에 대한 사용자의 주간 루틴을 무효화합니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_concierge/\[api_version}/presence/exception

기본 URL: `/api/sn_wsd_concierge/presence/exception`

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

{#wsd_presence-POST-exception__entry__2}{#wsd_presence-POST-exception__version-not_optional-RESTAPI}

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

{#wsd_presence-POST-exception__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 50. 쿼리 매개변수]

{#wsd_presence-POST-exception__entry__10}

| 이름 | 설명 |
|-|-|
| 예외 | 필수 일회성 현재 상태 재정의를 정의하는 예외 객체입니다. 데이터 유형: 객체 "exception": { "date": "String", "in_office": "Boolean", "location": "String", "origin": "String". "sys_id": "String" } |
| 예외.날짜 | 예외 날짜입니다. 형식: yyyy-MM-dd 데이터 유형: 문자열 |
| exception.in_office | 사용자가 이 날짜에 사무실에 출근할 것인지 여부를 나타내는 플래그입니다. 가능한 값: * `true`: 사용자가 사무실에 있습니다. * `false`: 사용자가 사무실에 없습니다. {#wsd_presence-POST-exception__ul_uwq_vfq_bjc} 데이터 유형: 부울 |
| 예외.위치 | 이 예외에 대한 사무실 위치의 이름 또는 식별자입니다. 데이터 유형: 문자열 |
| 예외.원본 | 예외의 소스입니다. 유효한 값은 다음과 같습니다. * `사용자`: 직원이 수동으로 생성합니다. * `시스템`: 플랫폼에서 자동으로 생성됩니다. * `수동`: 관리자가 생성하거나 사용자를 대신하여 생성합니다. {#wsd_presence-POST-exception__ul_mzn_kzp_bjc} 데이터 유형: 문자열 |
| exception.sys_id | 업데이트할 기존 예외의 Sys_id입니다. 테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception) 데이터 유형: 문자열 |
[표 51. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더 {#wsd_presence-POST-exception__section_zlj_rj5_bjc}

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

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

{#wsd_presence-POST-exception__table_amj_rj5_bjc} {#wsd_presence-POST-exception__table_bmj_rj5_bjc__entry__2}

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

{#wsd_presence-POST-exception__table_bmj_rj5_bjc}

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 필수 필드 날짜가 누락되었거나 날짜 형식이 잘못되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 54. 상태 코드]

{#wsd_presence-POST-exception__table_djt_dk5_bjc}

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

{#wsd_presence-POST-exception__entry__44}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "message": "String", "result": {Object} } |
| 결과.메시지 | 예외가 추가되었음을 알리는 확인 메시지입니다. 데이터 유형: 문자열 |
| 결과.결과 | 생성된 예외를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "exceptions": [Array] } |
| 결과.예외 | 생성된 예외에 대한 상세 정보를 포함하는 배열입니다. 데이터 유형: 객체 배열 "exceptions": [ { "date": "String", "location": "String", "in_office": Boolean, "origin": "String", "sys_id": "String" } ] |
| result.result.exceptions.date | 이 예외가 적용되는 날짜(yyyy-MM-dd 형식)입니다. 사용자의 루틴이 재정의되는 날짜입니다. 데이터 유형: 문자열 |
| result.result.exceptions.in_office | 사용자가 이 날짜에 사무실에 출근할 것인지 여부를 나타내는 플래그입니다. 이는 해당 요일에 주별 루틴이 지정하는 모든 것을 무효화합니다. 유효한 값은 다음과 같습니다. * `true`: 사용자가 사무실에 있습니다. * `false`: 사용자가 사무실에 있지 않음 {#wsd_presence-POST-exception__ul_ttw_2zp_bjc} 데이터 유형: 문자열 |
| 결과.결과.예외.위치 | 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. `in_office`이 예인 경우에만 관련이 있습니다`.` 사용자가 원격 근무인 경우 빈 문자열일 수 있습니다. 데이터 유형: 문자열 |
| 결과.결과.예외.원본 | 예외를 생성한 소스입니다. 유효한 값은 다음과 같습니다. * `사용자`: 직원이 수동으로 생성합니다. * `시스템`: 플랫폼에서 자동으로 생성됩니다. * `수동`: 관리자가 생성하거나 사용자를 대신하여 생성합니다. 데이터 유형: 문자열 |
| result.result.exceptions.sys_id | 예외 기록의 Sys_id입니다. 테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception) 데이터 유형: 문자열 |
[ ]

### cURL 요청

이 예에서는 2026년 2월 14일에 대한 현재 상태 예외를 생성하여 사용자를 건물 A의 사무실 내로 표시합니다.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/exception" \
    --request POST \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --user "username:password" \
    --data '{
      "exception": {
        "date": "2026-02-14",
        "in_office": true,
        "location": "Building A - Floor 3",
        "origin": "user"
      }
    }'

응답 본문.

    {
      "result": {
        "message": "Exception added successfully",
        "result": {
          "exceptions": [
            {
              "sys_id": "a1b2c3d4e5f6g7h8",
              "date": "2026-02-14",
              "in_office": true,
              "origin": "user",
              "location": "Building A - Floor 3"
            }
          ]
        }
      }
    }

## WSD 현재 상태 - POST /api/sn_wsd_concierge/v1/presence/routine {#ariaid-title11}

인증된 사용자에 대한 새로운 주간 오피스 루틴을 생성합니다. 사용자가 처음으로 현재 상태 루틴을 설정할 때 이 엔드포인트를 사용합니다.
7일 내내 부울 값으로 제공해야 합니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_concierge/{api_version}/presence/routine

기본 URL: /api/sn_wsd_concierge/presence/routine

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

{#wsd_presence-POST-routine__entry__2}{#wsd_presence-POST-routine__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| 루틴 | 필수 사용자의 주간 오피스 루틴입니다. 계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 사용자가 해당 날짜에 사무실에 출근할 계획이면 `true` 를 표시하고 출석이 계획되지 않은 경우에는 `false` 를 표시합니다. 모든 요일이 필요합니다. 데이터 유형: 객체 "routine": { "monday": "Boolean", "tuesday": "Boolean", "wednesday": "Boolean", "thursday": "Boolean", "friday": "Boolean", "saturday": "Boolean", "sunday": "Boolean" } |
[표 55. 경로 매개변수]

{#wsd_presence-POST-routine__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 56. 쿼리 매개변수]

{#wsd_presence-POST-routine__entry__12}

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

### 헤더 {#wsd_presence-POST-routine__section_zlj_rj5_bjc}

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

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

{#wsd_presence-POST-routine__table_amj_rj5_bjc} {#wsd_presence-POST-routine__table_bmj_rj5_bjc__entry__2}

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

{#wsd_presence-POST-routine__table_bmj_rj5_bjc}

### 상태 코드 {#wsd_presence-POST-routine__section_wmh_pn5_bjc}

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 필수 필드가 누락되었거나 데이터 유형이 잘못되었습니다. 7일을 모두 부울 값으로 제공해야 합니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 60. 상태 코드]

{#wsd_presence-POST-routine__table_djt_dk5_bjc}

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

{#wsd_presence-POST-routine__entry__36}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "message": "String", "result": {Object} } |
| 결과.메시지 | 루틴이 생성되었음을 알리는 확인 메시지입니다. 데이터 유형: 문자열 |
| 결과.결과 | 7일 내내 생성된 루틴 객체를 포함합니다. 데이터 유형: 객체 "result": { "routine": {Object} } |
| 결과.루틴 | 사용자의 주간 오피스 루틴입니다. 계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 사용자가 해당 날짜에 사무실에 출근할 계획이면 `true` 를 표시하고 출석이 계획되지 않은 경우에는 `false` 를 표시합니다. 데이터 유형: 객체 "routine": { "monday": "Boolean", "tuesday": "Boolean", "wednesday": "Boolean", "thursday": "Boolean", "friday": "Boolean", "saturday": "Boolean", "sunday": "Boolean" } |
[ ]

### cURL 요청

이 예에서는 월요일부터 목요일까지의 주간 오피스 루틴을 만듭니다.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/routine" \
    --request POST \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --user "username:password" \
    --data '{
      "routine": {
        "monday": true, "tuesday": true, "wednesday": true,
        "thursday": true, "friday": false, "saturday": false, "sunday": false
      }
    }'

응답 본문.

    {
      "result": {
        "message": "Routine created successfully",
        "result": {
          "routine": {
            "monday": true, 
            "tuesday": true, 
            "wednesday": true,
            "thursday": true, 
            "friday": false, 
            "saturday": false,
            "sunday": false
          }
        }
      }
    }

## WSD 현재 상태 - PUT /api/sn_wsd_concierge/v1/presence/exception {#ariaid-title12}

기존 현재 상태 예외를 취소하고 대체 항목을 만들어 업데이트합니다. 원래 예외는 해당 sys_id로 식별됩니다. 사용자가 이전에 생성된 예외의 상세 정보를 변경해야 하는 경우 이 엔드포인트를 사용합니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_concierge/{api_version}/presence/exception

기본 URL: /api/sn_wsd_concierge/presence/exception

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

{#wsd_presence-PUT-exception__entry__2}{#wsd_presence-PUT-exception__version-not_optional-RESTAPI}

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

{#wsd_presence-PUT-exception__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 62. 쿼리 매개변수]

{#wsd_presence-PUT-exception__entry__10}

| 이름 | 설명 |
|-|-|
| 예외 | 필수 업데이트된 상세 정보를 포함하는 예외 객체입니다. 및 in_office 필드는 sys_id 필수입니다. 데이터 유형: 객체 "exception": { "date": "String", "in_office": "Boolean", "location": "String", "origin": "String", "sys_id": "String" } |
| 예외.날짜 | 예외 날짜입니다. 형식: yyyy-MM-dd 데이터 유형: 문자열 |
| exception.in_office | 필수 사용자가 이 날짜에 사무실에 출근할 것인지 여부를 나타내는 플래그입니다. 가능한 값: * `true`: 사용자가 사무실에 있습니다. * `false`: 사용자가 사무실에 없습니다. {#wsd_presence-PUT-exception__ul_uwq_vfq_bjc} 데이터 유형: 부울 |
| 예외.위치 | 이 예외에 대한 사무실 위치의 이름 또는 식별자입니다. 데이터 유형: 문자열 |
| 예외.원본 | 예외의 소스입니다. 유효한 값은 다음과 같습니다. * `사용자`: 직원이 수동으로 생성합니다. * `시스템`: 플랫폼에서 자동으로 생성됩니다. * `수동`: 관리자가 생성하거나 사용자를 대신하여 생성합니다. {#wsd_presence-PUT-exception__ul_mzn_kzp_bjc} 데이터 유형: 문자열 기본값: user |
| exception.sys_id | 필수 업데이트할 기존 예외의 Sys_id입니다. 테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception) 데이터 유형: 문자열 |
[표 63. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더 {#wsd_presence-PUT-exception__section_zlj_rj5_bjc}

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

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

{#wsd_presence-PUT-exception__table_amj_rj5_bjc} {#wsd_presence-PUT-exception__table_bmj_rj5_bjc__entry__2}

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

{#wsd_presence-PUT-exception__table_bmj_rj5_bjc}

### 상태 코드 {#wsd_presence-PUT-exception__section_wmh_pn5_bjc}

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 누락된 필수 필드 sys_id 또는 in_office. |
| 404 | 찾을 수 없습니다. 지정된 예외를 찾을 수 없거나 사용자에게 예외를 수정할 수 있는 권한이 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 66. 상태 코드]

{#wsd_presence-PUT-exception__table_djt_dk5_bjc}

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

{#wsd_presence-PUT-exception__entry__46}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "message": "String", "result": {Object} } |
| 결과.메시지 | 예외가 업데이트되었음을 알리는 확인 메시지입니다. 데이터 유형: 문자열 |
| 결과.결과 | 업데이트된 예외를 포함합니다. 데이터 유형: 객체 "result": { "exceptions": [Array] } |
| 결과.결과.예외 | 현재 상태 예외 목록입니다. 데이터 유형: 객체 배열 "exceptions": [ { "sys_id": "sys_id", "date": "String", "in_office": String, "origin": "String", "location": "String" } ] |
| result.result.exceptions.sys_id | 예외 기록의 Sys_id입니다. 테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception) 데이터 유형: 문자열 |
| result.exceptions.date | 이 예외가 적용되는 날짜(yyyy-MM-dd 형식)입니다. 사용자의 루틴이 재정의되는 날짜입니다. 데이터 유형: 문자열 |
| result.exceptions.in_office | 사용자가 이 날짜에 사무실에 출근할 것인지 여부를 나타내는 플래그입니다. 이는 해당 요일에 주별 루틴이 지정하는 모든 것을 무효화합니다. 유효한 값은 다음과 같습니다. * `true`: 사용자가 사무실에 있습니다. * `false`: 사용자가 사무실에 있지 않음 {#wsd_presence-PUT-exception__ul_ttw_2zp_bjc} 데이터 유형: 문자열 |
| 결과.예외.원본 | 예외를 생성한 소스입니다. 유효한 값은 다음과 같습니다. * `사용자`: 직원이 수동으로 생성합니다. * `시스템`: 플랫폼에서 자동으로 생성됩니다. * `수동`: 관리자가 생성하거나 사용자를 대신하여 생성합니다. 데이터 유형: 문자열 |
| 결과.예외.위치 | 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. `in_office`이 예인 경우에만 관련이 있습니다`.` 사용자가 원격 근무인 경우 빈 문자열일 수 있습니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

이 예에서는 기존 예외를 업데이트하여 같은 날짜에 사용자의 상태를 원격(사무실 없음)으로 변경합니다.

    curl "https://<instance>.service-now.com/api/sn_wsd_concierge/v1/presence/exception" \
    --request PUT \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --user "username:password" \
    --data '{
      "exception": {
        "sys_id": "exc1a2b3c4d5e6",
        "in_office": false,
        "date": "2026-02-14",
        "location": "",
        "origin": "user"
      }
    }'

응답 본문.

    {
      "result": {
        "message": "Exception updated successfully",
        "result": {
          "exceptions": [
            { "sys_id": "exc9k0l1m2n3o4", "date": "2026-02-14", "in_office": false, "origin": "user", "location": "" }
          ]
        }
      }
    }