WSD 현재 상태 API

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 04월 27일
  • 소요 시간: 56분

    • WSD 현재 상태 API를 사용하면 사용자는 주간 루틴, 일회성 예외 및 공동 작업자 가시성을 포함하여 사무실 내 현재 상태 일정을 관리할 수 있습니다.

    이 API는 직원이 계획된 워크플레이스 서비스 제공 사무실 출석을 동료에게 전달할 수 있도록 하여 (WSD) 컨시어지 경험을 지원합니다. 다음 작업에 이 API를 사용합니다.
    • 주간 오피스 루틴, 예약된 예외, 선택적으로 공동 작업자의 현재 상태 정보를 포함하여 인증된 사용자의 전체 현재 상태 데이터를 검색합니다.
    • 직원이 반복 일정을 설정할 수 있도록 주간 오피스 루틴을 관리합니다.
    • 특정 날짜의 루틴을 재정의하는 일회성 예외를 생성하고 관리합니다.
    • 공동 작업자를 보고 관리하여 조정된 오피스 내 계획을 수립할 수 있습니다.

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

    WSD 현재 상태 API는 sn_wsd_concierge 네임스페이스에 속합니다. 컨시어지 플러그인이 활성 상태인 경우 WSD 예약 API GET /user/context 엔드포인트는 WSD 현재 상태 API에서 현재 상태 일정 데이터를 반환할 수 있습니다.

    요구 사항

    WSD 현재 상태 API에는 다음이 필요합니다.
    • 사용자에게 할당된 sn_wsd_core.workplace_user 역할입니다.
    • Core(com.sn_wsd_core) 플러그인이 워크플레이스 서비스 제공 활성화되었습니다.
    • sn_wsd_core.workplace_user 역할이 할당된 sys_user에 하나 이상의 사용자 기록이 있어야 합니다.

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

    인증된 사용자의 현재 상태 가시성 목록에서 공동 작업자를 제거합니다. 사용자가 더 이상 동료의 사무실 출석을 추적하지 않으려는 경우 이 엔드포인트를 사용합니다.

    인증된 사용자는 로그인되어 있거나 자격 증명이 API 요청에 포함된 사용자입니다. 공동 작업자는 sys_id로 식별됩니다.

    URL 형식

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

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

    지원되는 요청 매개변수

    표 1. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열
    collaborator_id 사용자의 가시성 목록에서 제거할 공동 작업자의 Sys_id입니다.

    테이블: 사용자 [sys_user]

    데이터 유형: 문자열
    표 2. 쿼리 매개변수
    이름 설명
    안 함
    표 3. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

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

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

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

    이름 설명
    결과 요청의 결과를 포함하는 객체입니다.

    데이터 유형: 객체

    "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}

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

    URL 형식

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

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

    지원되는 요청 매개변수

    표 7. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열
    exception_id 필수 삭제할 현재 상태 예외의 Sys_id입니다.

    테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception)

    데이터 유형: 문자열
    표 8. 쿼리 매개변수
    이름 설명
    안 함
    표 9. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

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

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

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

    이름 설명
    결과 요청의 결과를 포함하는 객체입니다.

    데이터 유형: 객체

    "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

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

    URL 형식

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

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

    지원되는 요청 매개변수

    표 13. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열
    표 14. 쿼리 매개변수
    이름 설명
    안 함
    표 15. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

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

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

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

    이름 설명
    결과 요청의 결과를 포함하는 객체입니다.

    데이터 유형: 객체

    "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: 공동 작업자의 현재 상태 데이터가 표시됩니다.

    데이터 유형: 부울
    결과.공동 작업자.루틴 공동 작업자의 주간 오피스 루틴입니다.

    계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 공동 작업자가 해당 날짜에 사무실에 출근할 계획이면 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: 사용자가 사무실에 있지 않음

    데이터 유형: 문자열
    result.collaborators.exceptions.origin 예외를 생성한 소스입니다.
    유효한 값은 다음과 같습니다.
    • 사용자: 직원이 수동으로 생성합니다.
    • 시스템: 플랫폼에서 자동으로 생성됩니다.
    • 수동: 관리자가 생성하거나 사용자를 대신하여 생성합니다.

    데이터 유형: 문자열
    결과.공동 작업자.예외.위치 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. 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

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

    URL 형식

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

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

    지원되는 요청 매개변수

    표 19. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열
    표 20. 쿼리 매개변수
    이름 설명
    exception_id 검색할 특정 예외의 Sys_id입니다.

    제공된 경우 날짜 범위 필터를 재정의하고 일치하는 예외만 반환합니다.

    테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception)

    데이터 유형: 문자열
    exception_start_date 예외 필터링의 시작 날짜입니다.

    형식: yyyy-MM-dd

    데이터 유형: 문자열

    기본값: 오늘
    exception_end_date 예외 필터링의 종료 날짜입니다.

    형식: yyyy-MM-dd

    데이터 유형: 문자열

    기본값: 오늘 +3개월
    표 21. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

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

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

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

    이름 설명
    결과 요청의 결과를 포함하는 객체입니다.

    데이터 유형: 객체

    "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: 사용자가 사무실에 있지 않음

    데이터 유형: 문자열
    결과.예외.위치 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. in_office이 예인 경우에만 관련이 있습니다. 사용자가 원격 근무인 경우 빈 문자열일 수 있습니다.

    데이터 유형: 문자열
    결과.예외.원본 예외를 생성한 소스입니다.
    유효한 값은 다음과 같습니다.
    • 사용자: 직원이 수동으로 생성합니다.
    • 시스템: 플랫폼에서 자동으로 생성됩니다.
    • 수동: 관리자가 생성하거나 사용자를 대신하여 생성합니다.

    데이터 유형: 문자열
    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

    주간 오피스 루틴, 예약된 현재 상태 예외, 선택적으로 공동 작업자의 현재 상태 정보를 포함하여 인증된 사용자의 전체 현재 상태 데이터를 검색합니다.

    이 엔드포인트를 사용하여 사용자의 계획된 사무실 출석에 대한 전체 뷰를 가져올 수 있습니다. 개인정보 설정에 따라 sys_id 제공하여 다른 사용자의 현재 상태 데이터를 쿼리할 수도 있습니다.

    URL 형식

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

    기본 URL: /api/sn_wsd_concierge/presence

    지원되는 요청 매개변수

    표 25. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열
    표 26. 쿼리 매개변수
    이름 설명
    user_id 현재 상태 데이터를 검색할 대상 사용자의 Sys_id입니다. 제공되지 않은 경우 인증된 사용자의 현재 상태 데이터를 반환합니다.
    주:
    사용자 간 쿼리는 호출자에게 명시적 허가가 없는 경우 401 Unauthortion을 반환합니다.

    테이블: 사용자 [sys_user]

    데이터 유형: 문자열
    exception_start_date 현재 상태 예외를 필터링하는 시작 날짜입니다.

    형식: yyyy-MM-dd

    데이터 유형: 문자열

    기본값: 오늘
    exception_end_date 현재 상태 예외를 필터링하기 위한 종료 날짜입니다.

    형식: yyyy-MM-dd

    데이터 유형: 문자열

    기본값: 오늘 + 3개월
    포함 응답에 포함할 관련 데이터입니다.

    유효한 값만: 공동 작업자

    데이터 유형: 문자열
    표 27. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

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

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

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

    이름 설명
    결과 응답의 결과를 포함하는 객체입니다.
    "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: 사용자가 사무실에 있지 않음

    데이터 유형: 문자열
    결과.예외.원본 예외를 생성한 소스입니다.
    유효한 값은 다음과 같습니다.
    • 사용자: 직원이 수동으로 생성합니다.
    • 시스템: 플랫폼에서 자동으로 생성됩니다.
    • 수동: 관리자가 생성하거나 사용자를 대신하여 생성합니다.

    데이터 유형: 문자열
    결과.예외.위치 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. 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: 공동 작업자의 현재 상태 데이터가 표시됩니다.

    데이터 유형: 부울
    결과.공동 작업자.루틴 공동 작업자의 주간 오피스 루틴입니다.

    계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 공동 작업자가 해당 날짜에 사무실에 출근할 계획이라면 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

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

    URL 형식

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

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

    지원되는 요청 매개변수

    표 31. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열
    표 32. 쿼리 매개변수
    이름 설명
    안 함
    표 33. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

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

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

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

    이름 설명
    결과 요청의 결과를 포함하는 객체입니다.

    데이터 유형: 객체

    "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

    인증된 사용자의 주간 오피스 루틴을 부분적으로 업데이트합니다. 사용자가 전체 일정을 재설정하지 않고 특정 요일을 조정해야 하는 경우 이 엔드포인트를 사용합니다.

    요청 본문에 제공된 날짜만 업데이트됩니다. 나머지 날짜는 모두 변경되지 않습니다.

    URL 형식

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

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

    지원되는 요청 매개변수

    표 37. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열
    표 38. 쿼리 매개변수
    이름 설명
    안 함
    표 39. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    루틴 필수 인증된 사용자의 주간 루틴입니다.

    계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 인증된 사용자가 해당 날짜에 사무실에 출근할 계획이면 true 를 표시하고 출석이 계획되지 않은 경우에는 false 를 표시합니다.

    요청에서 생략된 날짜는 변경되지 않습니다. 빈 루틴 객체는 no-op으로 허용됩니다.

    데이터 유형: 객체

    "routine": { 
   "monday": "Boolean", 
   "tuesday": "Boolean", 
   "wednesday": "Boolean", 
   "thursday": "Boolean", 
   "friday": "Boolean", 
   "saturday": "Boolean", 
   "sunday": "Boolean" 
}

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

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

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

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

    이름 설명
    결과 요청의 결과를 포함하는 객체입니다.

    데이터 유형: 객체

    "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

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

    URL 형식

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

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

    지원되는 요청 매개변수

    표 43. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열
    표 44. 쿼리 매개변수
    이름 설명
    안 함
    표 45. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    collaborator_ids 필수 공동 작업자로 추가할 사용자를 식별하는 비어 있지 않은 sys_id 값 배열입니다.

    테이블: 사용자 [sys_user]

    데이터 유형: 문자열 배열
    "collaborator_ids": ["String", "String"]

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

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

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

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

    이름 설명
    결과 요청의 결과를 포함하는 객체입니다.

    데이터 유형: 객체

    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: 공동 작업자의 현재 상태 데이터가 표시됩니다.

    데이터 유형: 부울
    결과.공동 작업자.루틴 공동 작업자의 주간 오피스 루틴입니다.

    계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 공동 작업자가 해당 날짜에 사무실에 출근할 계획이라면 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: 사용자가 사무실에 있지 않음

    데이터 유형: 문자열
    result.collaborators.exceptions.origin 예외를 생성한 소스입니다.
    유효한 값은 다음과 같습니다.
    • 사용자: 직원이 수동으로 생성합니다.
    • 시스템: 플랫폼에서 자동으로 생성됩니다.
    • 수동: 관리자가 생성하거나 사용자를 대신하여 생성합니다.

    데이터 유형: 문자열
    결과.공동 작업자.예외.위치 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. 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

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

    예외는 해당 날짜에 대한 사용자의 주간 루틴을 무효화합니다.

    URL 형식

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

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

    지원되는 요청 매개변수

    표 49. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열
    표 50. 쿼리 매개변수
    이름 설명
    안 함
    표 51. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    예외 필수 일회성 현재 상태 재정의를 정의하는 예외 객체입니다.

    데이터 유형: 객체

    "exception": { 
  "date": "String", 
  "in_office": "Boolean",
  "location": "String", 
  "origin": "String".
  "sys_id": "String"
}
    예외.날짜 예외 날짜입니다.

    형식: yyyy-MM-dd

    데이터 유형: 문자열
    exception.in_office 사용자가 이 날짜에 사무실에 출근할 것인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 사용자가 사무실에 있습니다.
    • false: 사용자가 사무실에 없습니다.

    데이터 유형: 부울
    예외.위치 이 예외에 대한 사무실 위치의 이름 또는 식별자입니다.

    데이터 유형: 문자열
    예외.원본 예외의 소스입니다.
    유효한 값은 다음과 같습니다.
    • 사용자: 직원이 수동으로 생성합니다.
    • 시스템: 플랫폼에서 자동으로 생성됩니다.
    • 수동: 관리자가 생성하거나 사용자를 대신하여 생성합니다.
    데이터 유형: 문자열
    exception.sys_id 업데이트할 기존 예외의 Sys_id입니다.

    테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception)

    데이터 유형: 문자열

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

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

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

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

    이름 설명
    결과 요청의 결과를 포함하는 객체입니다.

    데이터 유형: 객체

    "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: 사용자가 사무실에 있지 않음

    데이터 유형: 문자열
    결과.결과.예외.위치 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. 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

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

    7일 내내 부울 값으로 제공해야 합니다.

    URL 형식

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

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

    지원되는 요청 매개변수

    표 55. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열
    루틴 필수 사용자의 주간 오피스 루틴입니다.

    계획된 사무실 출석을 나타내는 각 요일의 부울 플래그를 포함합니다. 사용자가 해당 날짜에 사무실에 출근할 계획이면 true 를 표시하고 출석이 계획되지 않은 경우에는 false 를 표시합니다.

    모든 요일이 필요합니다.

    데이터 유형: 객체

    "routine": { 
   "monday": "Boolean", 
   "tuesday": "Boolean", 
   "wednesday": "Boolean", 
   "thursday": "Boolean", 
   "friday": "Boolean", 
   "saturday": "Boolean", 
   "sunday": "Boolean" 
}
    표 56. 쿼리 매개변수
    이름 설명
    안 함
    표 57. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

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

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

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

    이름 설명
    결과 요청의 결과를 포함하는 객체입니다.

    데이터 유형: 객체

    "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

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

    URL 형식

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

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

    지원되는 요청 매개변수

    표 61. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열
    표 62. 쿼리 매개변수
    이름 설명
    안 함
    표 63. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    예외 필수 업데이트된 상세 정보를 포함하는 예외 객체입니다. 및 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: 사용자가 사무실에 없습니다.

    데이터 유형: 부울
    예외.위치 이 예외에 대한 사무실 위치의 이름 또는 식별자입니다.

    데이터 유형: 문자열
    예외.원본 예외의 소스입니다.
    유효한 값은 다음과 같습니다.
    • 사용자: 직원이 수동으로 생성합니다.
    • 시스템: 플랫폼에서 자동으로 생성됩니다.
    • 수동: 관리자가 생성하거나 사용자를 대신하여 생성합니다.

    데이터 유형: 문자열

    기본값: user
    exception.sys_id 필수 업데이트할 기존 예외의 Sys_id입니다.

    테이블: 직원 현재 상태 예외(sn_wsd_concierge_employee_presence_exception)

    데이터 유형: 문자열

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

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

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

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

    이름 설명
    결과 요청의 결과를 포함하는 객체입니다.

    데이터 유형: 객체

    "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: 사용자가 사무실에 있지 않음

    데이터 유형: 문자열
    결과.예외.원본 예외를 생성한 소스입니다.
    유효한 값은 다음과 같습니다.
    • 사용자: 직원이 수동으로 생성합니다.
    • 시스템: 플랫폼에서 자동으로 생성됩니다.
    • 수동: 관리자가 생성하거나 사용자를 대신하여 생성합니다.

    데이터 유형: 문자열
    결과.예외.위치 이 날짜에 사용자가 있을 사무실 위치의 이름 또는 식별자입니다. 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": "" }
      ]
    }
  }
}