WSD 예약 API
(WSD) 예약 API는 워크플레이스 서비스 제공 직장 예약 관리를 위한 엔드포인트를 제공합니다.
이 API에 접근하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 하며 Workplace Safety Management(sn_wsd_core) 및 Workplace Reservation Management(sn_wsd_rsv) 플러그인이 활성화되어 있어야 합니다.
이 API는 sn_wsd_rsv 네임스페이스에서 실행됩니다.
에 대한 워크플레이스 예약 관리자세한 내용은 워크플레이스 예약 관리를 참조하십시오.
WSD 예약 - GET /api/sn_wsd_rsv/reservation/get
지정된 직장 예약을 조회합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/reservation/get
기본 URL: /api/sn_wsd_rsv/reservation/get
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| external_ical | 예약의 고유한 외부 iCalendar ID입니다. 달력 동기화 관련 예약인 경우 이 값을 사용하여 예약을 식별합니다. 연결된 외부 iCalendar 애플리케이션에서 이 값을 가져옵니다. 데이터 유형: 문자열 |
| external_id | 예약의 고유한 외부 ID입니다. 달력 동기화 관련 예약인 경우 이 값을 사용하여 예약을 식별합니다. 연결된 외부 애플리케이션에서 이 값을 가져옵니다. 데이터 유형: 문자열 |
| include_multi_child_data | 연결된 직장 예약 [sn_wsd_rsv_reservation] 기록의 reservation_subtype 필드 값이 multi_child로 설정된 경우 이 플래그는 예약 상세 정보를 반환할지 여부를 나타냅니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 기본값: false |
| include_standard_services | 응답에서 표준 서비스 정보를 반환할지 여부를 나타내는 플래그입니다. 표준 서비스는 화이트 보드, 추가 모니터 및 이와 유사한 서비스와 같이 예약 시 예약 가능한 직장 항목에서 사용할 수 있는 기본 조항을 설명합니다. 표준 서비스에 대한 자세한 내용은 표준 서비스를 참조하세요. 이 정보는 표준 서비스 [sn_wsd_rsv_standard_service] 테이블에 있습니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 기본값: false |
| sys_id | 필수 예약 기록의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 없음 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.
| 헤더 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, application/xml 또는, text/xml. 기본값: application/json |
| 헤더 | 설명 |
|---|---|
| 없음 |
상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| 결과.예약 | 예약에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.active | 예약이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| 결과.예약.참석자 | 예약 참석자 목록입니다. 데이터 형식: 객체 배열 |
| 결과.예약.참석자.아바타 | 참석자와 연결된 아바타의 Sys_id입니다. 첨부 파일 [sys_attachment] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.attendees.displayValue | 참석자의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservation.attendees.display_value | 참석자의 표시 값입니다. 와 displayValue동일합니다. 데이터 유형: 문자열 |
| result.reservation.attendees.email | 참석자의 이메일 주소입니다. 데이터 유형: 문자열 |
| 결과.예약.참석자.이니셜 | 참석자 이니셜 데이터 유형: 문자열 |
| result.reservation.attendees.name | 참석자 이름. 데이터 유형: 문자열 |
| result.reservation.attendees.sys_id | 참석자 기록을 Sys_id_of. 데이터 유형: 문자열 |
| 결과.예약.참석자.테이블 | 참석자 기록이 존재하는 테이블입니다. 데이터 유형: 문자열 |
| result.reservation.attendees.user_name | 참석자의 사용자 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.참석자.값 | 참석자의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservation.check_in_state | 예약의 체크인 상태에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.check_in_state.display_value | 진행 중 또는 완료와 같은 예약의 현재 체크인 상태에 대한 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.check_in_state.value | 예약의 현재 체크인 상태에 대한 내부 값(예: 2). 데이터 유형: 문자열 |
| result.reservation.edit_restriction | 예약에 대한 사용자 편집 제한에 대한 설명입니다(예: no_restrictions, service_only 또는 fully_restricted). 데이터 유형: 객체 |
| result.reservation.edit_restriction.display_value | 제한 없음과 같은 예약에 대한 편집 제한의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.edit_restriction.value | 예약에 대한 편집 제한의 내부 값( 예: no_restriction)입니다. 데이터 유형: 문자열 |
| 결과.예약.종료 | 예약 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| result.reservation.external_ical | 예약의 고유한 외부 iCalendar ID입니다. 달력 동기화 관련 예약인 경우 이 값을 사용하여 예약을 식별합니다. 데이터 유형: 문자열 |
| result.reservation.external_id | 예약의 고유한 외부 ID입니다. 달력 동기화 관련 예약인 경우 이 값을 사용하여 예약을 식별합니다. 데이터 유형: 문자열 |
| result.reservation.is_parent | 이 예약이 상위 예약인지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.reservation.is_private | 예약이 비공개인지 여부를 나타내는 플래그입니다. 비공개인 경우 예약은 소유자를 제외한 다른 사람에게 표시되지 않습니다. 이러한 개인 정보 설정에 대한 자세한 내용은 위치 개인 정보 보호 설정 및 영향을 참조하세요. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 기본값: 시스템 속성에서 개인정보 보호에 대해 설정된 값입니다. |
| result.reservation.last_updated_sub_source | 예약의 마지막으로 업데이트된 하위 소스에 대한 세부 정보입니다. 하위 소스는 예약을 외부 달력과 통합할 때 사용됩니다. 이 객체에는 "servicenow_workplace_service_delivery", "google_calendar" 또는 "microsoft_exchange"와 같은 정보가 포함됩니다. 데이터 유형: 객체 |
| result.reservation.last_updated_sub_source.display_value | ServiceNow 워크플레이스 서비스 제공 또는 Google 달력과 같은 예약의 마지막으로 업데이트된 하위 소스에 대한 값을 표시합니다. 예약을 Google 캘린더 또는 Microsoft Outlook과 같은 외부 서비스와 통합할 때 사용됩니다. 데이터 유형: 문자열 |
| result.reservation.last_updated_sub_source.값 | 예약의 마지막으로 업데이트된 하위 소스에 대한 내부 값입니다(예: servicenow_workplace_service_delivery 또는 google_calendar). 예약을 Google 캘린더 또는 Microsoft Outlook과 같은 외부 서비스와 통합할 때 사용됩니다. 데이터 유형: 문자열 |
| 결과.예약.위치 | 예약과 관련된 위치에 대한 세부 정보입니다. 데이터 유형: 객체 |
| 결과.예약.위치.지역 | 위치와 연결된 영역에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.area.active | 영역이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.area.display_value | 이 위치가 속한 영역의 값을 표시합니다(예: 책상 A2). 데이터 유형: 문자열 |
| result.reservation.location.area.sys_id | 이 위치가 속한 지역의 Sys_id입니다. 영역 [sn_wsd_core_area] 테이블에 있습니다. 데이터 유형: 문자열 |
| 결과.예약.위치.건물 | 위치와 연결된 건물에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.building.active | 건물이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.building.display_value | 이 위치가 속한 건물의 값을 표시합니다(예: AMS - 빌딩1). 데이터 유형: 문자열 |
| result.reservation.location.building.sys_id | 이 위치가 속한 건물의 Sys_id입니다. 건물 [sn_wsd_core_building] 테이블에 있습니다. 데이터 유형: 문자열 |
| 결과.예약.위치.건물.시간대 | 위치와 연결된 시간대에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.building.timezone.display_value | 이 위치가 속한 시간대의 값을 표시합니다. 데이터 유형: 문자열 |
| 결과.예약.위치.건물.시간대.값 | 이 위치가 속한 시간대의 내부 값입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.캠퍼스 | 위치와 관련된 캠퍼스에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.campus.active | 캠퍼스가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.campus.display_value | 암스테르담 캠퍼스 등 이 위치가 속한 캠퍼스의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.location.campus.sys_id | 이 위치가 속한 캠퍼스의 Sys_id입니다. 캠퍼스 [sn_wsd_core_campus] 테이블에 있습니다. 데이터 유형: 문자열 |
| 결과.예약.위치.용량 | 해당 위치의 최대 점유자 수입니다. 데이터 유형: 숫자 |
| 결과.예약.위치.설명 | 위치에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservation.location.display_value | 이 위치의 UI에 표시할 값입니다. 데이터 유형: 문자열 |
| result.reservation.location.email | 위치의 이메일 주소입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.층 | 위치와 연결된 층에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.floor.active | 층이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.floor.display_value | 이 위치가 속한 층의 값을 표시합니다(예: 1층). 데이터 유형: 문자열 |
| result.reservation.location.floor.sys_id | 이 위치가 속한 층의 Sys_id입니다. 층 [sn_wsd_core_floor] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.location.label_value | 매개변수에 name 지정된 값의 유형입니다(예: 방 이름). 데이터 유형: 문자열 |
| result.reservation.location.name | 위치 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.번호 | 예약 번호입니다. 데이터 유형: 문자열 |
| result.reservation.location.number_of_attendees | 예약 참석자 수입니다. 데이터 유형: 숫자 |
| 결과.예약.위치.지역 | 위치와 연결된 지역에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.region.active | 지역이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.region.display_value | 이 위치가 속한 지역의 값(예: 유럽)을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.location.region.sys_id | 이 위치가 속한 지역의 Sys_id입니다. 지역 [sn_wsd_core_region] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.location.requested_for | 대신 예약을 요청한 사람에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.requested_for.이름 | 예약을 요청한 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.location.requested_for.sys_id | 예약이 요청되는 사용자의 Sys_id입니다. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.location.requested_for.user_name | 예약을 요청한 사용자의 사용자 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.예약 | 위치와 관련된 예약에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.reservation.active | 예약이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| 결과.예약.위치.예약.번호 | 예약 번호입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservation.number_of_attendees | 예약 참석자 수입니다. 데이터 유형: 숫자 |
| result.reservation.location.reservation.requested_for | 대신 예약을 요청한 사람에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.reservation.requested_for.이름 | 예약을 요청한 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservation.requested_for.sys_id | 요청 대상 사용자의 Sys_id입니다. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.location.reservation.requested_for.사용자_이름 | 예약을 요청한 사용자의 사용자 이름입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservable_module | 예약과 관련된 예약 가능한 모듈에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.reservable_module.inline_title | 예약 가능한 모듈의 인라인 제목입니다. 제목은 직장 서비스 포털의 설명 텍스트와 나란히 표시됩니다. 데이터 유형: 문자열 |
| result.reservation.location.reservable_module.이름 | 예약 가능한 모듈의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservable_module.sys_id | 예약 가능한 모듈의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservable_module.타이틀 | 예약 가능한 모듈의 제목입니다. 데이터 유형: 문자열 |
| result.reservation.location.site | 위치가 속한 사이트입니다. 사이트 [sn_wsd_core_site] 테이블에 있습니다. 데이터 유형: 객체 |
| result.reservation.location.site.active | 사이트가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.site.display_value | 이 위치가 속한 사이트의 값 표시입니다(예: 서유럽). 데이터 유형: 문자열 |
| result.reservation.location.site.sys_id | 이 위치가 속한 사이트의 Sys_id입니다. 사이트 [sn_wsd_core_site] 테이블에 있습니다. 데이터 유형: 문자열 |
| 결과.예약.위치.상태 | 위치의 예약 상태에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.state.display_value | 예약의 현재 상태에 대한 값을 표시합니다(예: 확인됨). 데이터 유형: 문자열 |
| 결과.예약.위치.상태.값 | 예약의 현재 상태에 대한 내부 값(예: 2)입니다. 데이터 유형: 문자열 |
| result.reservation.location.sys_id | 연결된 위치 기록의 Sys_id입니다. 직장 위치[sn_wsd_core_workplace_location] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.notification_custom_message | 에 나열된 수신자에게 전송되는 알림에 대한 사용자 지정 메시지입니다 reservation.notification_recipients. 데이터 유형: 문자열 |
| result.reservation.notification_recipients | 예약에 대한 알림을 받는 수신자 목록입니다. 데이터 형식: 객체 배열 |
| result.reservation.notification_recipients.name | 수신자의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.notification_recipients.sys_id | 수신자의 Sys_id입니다. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.notification_recipients.user_name | 수신자의 사용자 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.번호 | 예약 기록의 고유 번호입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 이 값을 사용하여 예약을 쿼리할 수 있습니다. 데이터 유형: 문자열 |
| result.reservation.opened_by | 예약을 생성한 사용자에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.opened_by.아바타 | 예약을 연 사용자의 아바타입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.displayValue | 사용자가 연 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.display_value | 사용자가 연 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.email | 예약을 연 사용자의 이메일 주소입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.이니셜 | 예약을 오픈한 사용자의 이니셜입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.레이블 | 예약을 오픈한 사용자의 레이블입니다. 사용자의 직함과 부서를 조합한 것입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.name | 예약을 연 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.rservation.opened_by.sys_id | 예약을 오픈한 사용자를 Sys_id_of. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.rservation.opened_by.테이블 | 사용자 기록이 포함된 테이블입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.사용자_이름 | 예약을 연 사용자의 사용자 이름입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.value | 예약을 연 사용자의 내부 값입니다. 데이터 유형: 문자열 |
| 결과.예약.번호 | 예약 번호입니다. 데이터 유형: 문자열 |
| result.reservation.number_of_attendees | 이 예약의 참석자 수입니다. 데이터 유형: number |
| result.reservation.recording_details | 예약(회의)과 관련된 녹화에 대한 상세 정보입니다. 데이터 유형: 배열 |
| result.reservation.recording_details.recording_url | 예약과 관련된 기록의 URL입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for | 대신 예약한 사용자에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.requested_for.아바타 | 대신 예약한 사용자의 아바타입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.displayValue | 대신 예약한 사용자의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.display_value | 대신 예약한 사용자의 값을 표시합니다. 와 displayValue동일합니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.email | 대신 예약한 사용자의 이메일 주소입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.이니셜 | 대신 예약한 사용자의 이니셜입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.레이블 | 대신 예약한 사용자의 레이블입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.name | 대신 예약한 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.rservation.requested_for.sys_id | 대신 예약한 사용자를 Sys_id_of. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.rservation.requested_for.테이블 | 사용자 기록이 포함된 테이블입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.사용자_이름 | 대신 예약한 사용자의 사용자 이름입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.value | 대신 예약이 이루어진 사용자의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module | 요청된 예약 가능한 모듈에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservable_module.allow_invitees | 직원이 예약에 초대를 추가할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.allow_whole_day | 사용자가 하루 종일 예약 가능한 항목을 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.apply_to_shift | 예약 가능한 모듈에 대해 교대조 기반 예약이 활성화되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.browse_by_area_enabled | 사용자가 영역별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.browse_near_a_person_enabled | 사용자가 지정된 사람이 찾은 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.buildingSysIds | 예약 가능한 모듈과 연결된 건물 sys_ids 목록입니다. 데이터 형식: 문자열 배열 |
| result.reservation.reservable_module.checkin_before_minutes | 예약이 시작되기 전에 사용자가 예약에 체크인할 수 있는 시간입니다. 단위: 분 데이터 유형: 숫자 |
| result.reservation.reservable_module.display_number_of_attendees | 사용자가 예약의 참석자 수를 지정할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.display_on_behalf_of | 다른 사람을 대신하여 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.display_sensitivity | 사용자가 예약의 민감도(예: 일반 또는 비공개)를 설정할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.display_value | 예약 가능한 모듈의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.enable_browse_by_area | 사용자가 영역별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 와 browse_by_area_enabled동일합니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.enable_browse_near_a_person | 사용자가 지정된 사람이 찾은 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 와 browse_near_a_person_enabled 같습니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.enable_facet_filter | 작업장 항목에 대한 패싯 필터링이 활성화되어 있는지 여부를 나타내는 플래그입니다. 이 옵션을 사용하면 표시되는 필터 옵션은 검색 결과를 기반으로 합니다. 사용자는 생성된 검색 결과에서 사용할 수 있는 항목만 필터에서 선택할 수 있습니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.enable_group_reservations | 사용자가 그룹을 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.enable_ical_generation | 사용자가 예약에 대한 iCalendar를 생성할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.font_awesome_icon | 예약 가능한 모듈에 연결된 글꼴 아이콘의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.inline_title | 예약 가능한 모듈의 인라인 제목입니다. 제목은 직장 서비스 포털의 설명 텍스트와 나란히 표시됩니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping | 위치의 레이아웃 매핑 구조에 대한 상세 정보입니다. 이 데이터를 사용하여 UI에 정보를 배치합니다. 데이터 유형: 객체 |
| result.reservation.reservable_module.layout_mapping.본문 | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 형식: 객체 배열 |
| result.reservation.reservable_module.layout_mapping.body.field | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.body.field_to_display입니다. | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.body.icon | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.body.label | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.설명 | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 레이아웃 매핑에 대한 설명입니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.layout_mapping.이미지 | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.부제목 | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.layout_mapping.subtitle_asc | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.layout_mapping.제목 | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.max_days_in_future | 사용자가 예약 가능한 모듈을 예약할 수 있는 미래의 최대 일수입니다. 데이터 유형: 숫자 |
| result.reservation.reservable_module.max_occurrences | 예약 가능한 모듈에 반복 예약을 사용할 수 있는 경우 반복 예약 발생의 최대 수입니다. 데이터 유형: 숫자 |
| result.reservation.reservable_module.name | 예약 가능한 모듈의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.override_approval_policy | 승인 정책을 구현하는 방법을 지정하는 옵션입니다. 선택 사항은 다음과 같습니다.
데이터 유형: 문자열 |
| result.reservation.reservable_module.require_cancel_notes | 예약 가능한 모듈을 취소하기 전에 사용자가 취소 메모를 입력해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.require_cc_dept_check | 작업 공간 항목과 로그인한 사용자 간에 비용 센터 또는 부서 불일치가 있는지 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.require_subject | 예약 시 사용자가 제목을 입력해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.reservable_columns | 예약 가능한 열의 목록입니다. 직장 위치[sn_wsd_core_workplace_location] 테이블에 있습니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.reservable_container_field | 컨테이너의 수준입니다(예: 특정 영역의 책상 그룹). 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_filter | 연결된 예약 가능한 테이블에서 예약 가능한 항목을 필터링하는 데 사용되는 필터 조건입니다. 예약 가능한 테이블은 예약 가능한 모듈 [sn_wsd_rsv_reservable_module] 테이블의 필드입니다. 이러한 필터 조건은 필드 예약 가능한 테이블에 포함된 테이블에 적용되었습니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_quantity_field | 모든 공간의 예약 가능한 수량입니다. 이 수량은 영역에 인접 공간을 할당할 때 사용됩니다. 자세한 내용은 영역에 인접 공간 할당을 참고하세요. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_table | 예약 가능한 직장 항목을 포함하는 테이블입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_type | 위치와 같은 예약 가능한 항목의 유형입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_views | 카드 뷰 또는 일정 뷰와 같이 예약 가능한 모듈과 연결된 다양한 뷰에 대한 상세 정보입니다. 예약 가능한 뷰 [sn_wsd_rsv_reservable_view] 테이블에 있습니다. 데이터 유형: 객체 |
| result.reservation.reservable_module.reservable_views.icon클래스 | 예약 가능한 뷰의 아이콘 클래스입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_views.isDefault | 이 예약 가능한 뷰를 예약 가능한 모듈의 기본값으로 설정할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.reservable_views.레이블 | 예약 가능한 뷰의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_views.주문 | UI에서 예약 가능한 모듈에 대한 뷰가 표시되는 순서입니다. UI에서 순서 번호가 낮을수록 먼저 표시됩니다. 동일한 주문 번호의 경우 무작위 순서가 할당됩니다. 데이터 유형: 숫자 |
| result.reservation.reservable_module.reservable_views.type | 예약 가능한 뷰의 백엔드 이름입니다. 내부 처리에 사용됩니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservation_paths | 모두 찾아보기, 사람 근처 탐색 등 예약 가능한 모듈과 연결된 예약 경로입니다. 데이터 형식: 객체 배열 |
| result.reservation.reservable_module.reservation_paths.display_value | 예약 경로에 대한 값을 표시합니다(예: "사람 근처 탐색"). 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservation_paths.값 | 예약 경로의 내부 값(예: "browse_near_a_person")입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.search_limit | 사용자가 직장 위치를 검색할 때 반환할 최대 검색 결과 수입니다. 데이터 유형: 숫자 |
| result.reservation.reservable_module.selection_type | 검색 결과에 표시할 선택 유형입니다. 다음 옵션 중 하나일 수 있습니다.
데이터 유형: 문자열 |
| result.reservation.reservable_module.short_description | 예약 가능한 모듈에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.show_map_view | 예약 가능한 모듈에 대해 맵 뷰를 사용할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.sys_id | 예약 가능한 모듈의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots | 예약 가능한 모듈에 연결된 시간 슬롯에 대한 상세 정보입니다. 데이터 형식: 객체 배열 |
| result.reservation.reservable_module.timeSlots.name | 시간 슬롯의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots.short_description | 타임 슬롯에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots.slot_end | 시간 슬롯의 종료 시간입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots.slot_start | 슬롯의 시작 시간입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots.sys_id | 시간 슬롯 기록의 Sys_id입니다. 시간 슬롯 [sn_wsd_rsv_time_slot] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.제목 | 예약 가능한 모듈의 제목입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.virtual_meeting_provider | 예약 가능한 모듈과 연결된 가상 제공자에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservable_module.virtual_meeting_provider.display_value | 가상 회의 제공자의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.virtual_meeting_provider.sys_id | 가상 회의 공급자의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservation.reservationAcl | 연결된 예약에 설정된 사용자 접근 제어 수준(ACL) 검사의 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservationAcl.read | 사용자가 이 예약을 읽을 수 있는지 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write | 연결된 예약의 사용자 쓰기 기능에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservationAcl.write.allFields | 사용자가 객체에 지정된 모든 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다 reservationACL.write.fields . 사용자가 일부 특정 필드에만 액세스할 수 있는 경우 해당 필드만 객체에서 reservationACL.write.fields true입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields | 예약의 다양한 필드에 대한 접근 통제에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservationAcl.write.fields.location | 사용자가 이 예약의 위치 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields.number_of_attendees | 사용자가 이 예약의 참석자 수 필드에 쓸 수 있는지 여부를 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields.requested_for | 사용자가 이 예약의 요청 대상 필드에 쓸 수 있는지 여부를 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields.sensitivity | 사용자가 이 예약의 민감도 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields.subject | 사용자가 이 예약의 제목 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.record | 사용자가 전체 예약 기록에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservation_purpose | 예약 목적에 대한 자세한 내용입니다. 데이터 유형: 객체 |
| result.reservation.reservation_purpose.display_value | 회사 회의와 같은 예약 목적의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservation_purpose.value | 예약의 목적에 대한 내부 값입니다(예: company_meeting). 데이터 유형: 문자열 |
| result.reservation.reservation_type | 예약 유형에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservation_type.display_value | 공간과 같은 예약 유형에 대한 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservation_type.value | 공간과 같은 예약 유형에 대한 내부 값입니다. 데이터 유형: 문자열 |
| result.reservation.reservation_subtype | 예약의 하위 유형에 대한 세부 정보입니다. 하위 유형은 예약 유형(예: 단일, 다중 상위, 다중 하위, 반복 상위 또는 발생)을 나타냅니다. 데이터 유형: 객체 |
| result.reservation.reservation_subtype.display_value | 예약 하위 유형(예: 단일)에 대한 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservation_subtype.값 | 예약 하위 유형에 대한 내부 값입니다(예: 단일). 데이터 유형: 문자열 |
| 결과.예약.민감도 | 예약의 민감도에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.sensitivity.display_value | 예약 민감도의 표시 값(예: 높음 또는 낮음)입니다. 데이터 유형: 문자열 |
| 결과.예약.민감도.값 | 예약의 민감도에 대한 내부 값(예: 1 또는 3)입니다. 데이터 유형: 문자열 |
| 결과.예약.교대조 | 예약에 적용된 교대조에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.shift.display_value | 교대조의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.shift.name | 교대조의 이름입니다. 와 display_value동일합니다. 데이터 유형: 문자열 |
| 결과.예약.교대조.교대조 상세 정보 | 교대조의 상세 정보입니다. 데이터 유형: 문자열 |
| result.reservation.shift.sys_id | 교대조 기록의 Sys_id입니다. 교대조 [sn_wsd_core_shift] 테이블에 있습니다. 데이터 유형: 문자열 |
| 결과.예약.소스 | 예약 소스에 대한 상세 정보(예: 직장 서비스 또는 Google Mail)입니다. 데이터 유형: 객체 |
| result.reservation.source.display_value | 직장 서비스와 같은 예약 소스의 값을 표시합니다. 데이터 유형: 문자열 |
| 결과.예약.소스.값 | 예약 소스의 내부 값입니다(예: ServiceNow). 데이터 유형: 문자열 |
| result.reservation.source_icon | 예약에 사용된 아이콘의 소스에 대한 세부 정보입니다. 이 아이콘은 UI에서 사용됩니다. 데이터 유형: 객체 |
| result.reservation.source_icon.클래스 이름 | 소스 아이콘의 클래스 이름(쉼표로 구분됨). 데이터 유형: 문자열 |
| result.reservation.source_icon.imgSrc | 소스 아이콘에 대한 이미지 소스의 이름입니다. 이 아이콘은 이미지 [db_image] 테이블에 저장됩니다. 데이터 유형: 문자열 |
| result.reservation.source_icon.tooltip | 소스 아이콘에 연결된 도구 설명입니다. 데이터 유형: 문자열 |
| result.reservation.source_reservation | 현재 예약의 소스 예약입니다. 예를 들어 여러 예약의 경우 상위 예약이 하위 예약의 소스입니다. 데이터 유형: 문자열 |
| 결과.예약.시작 | 예약 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| 결과.예약.제목 | 예약의 주제입니다. 데이터 유형: 문자열 |
| result.reservation.sub_source | 예약의 하위 소스에 대한 세부 정보입니다. 하위 소스는 예약이 시작된 위치(예: Google 캘린더 또는 Microsoft Exchange)를 지정합니다. 데이터 유형: 객체 |
| result.reservation.sub_source.display_value | Google 달력과 같은 예약의 하위 소스에 대한 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.sub_source.value | 예약의 하위 소스 필드에 대한 내부 값입니다(예: google_calendar). 데이터 유형: 문자열 |
| result.reservation.sync_state | "sync_enqueued" 또는 "동기화됨"과 같은 다른 서비스의 예약 동기화 상태에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.sync_state.display_value | 예약의 현재 동기화 상태에 대한 값(예: 동기화됨)을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.sync_state.value | 예약의 현재 동기화 상태의 내부 값(예: 동기화됨)입니다. 데이터 유형: 문자열 |
| result.reservation.sys_created_on | 예약이 생성된 날짜 및 시간입니다. 데이터 유형: 문자열 |
| result.reservation.sys_id | 필수 예약 기록의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 데이터 유형: 문자열 |
| Result.reservation.sys_updated_on | 예약이 마지막으로 업데이트된 날짜 및 시간입니다. 데이터 유형: 문자열 |
| result.reservation.virtual_meeting | 가상 회의 링크의 URL입니다. 데이터 유형: 문자열 |
| result.reservationAcl | 연결된 예약에 설정된 사용자 접근 제어 수준(ACL) 검사의 상세 정보입니다. 데이터 유형: 객체 |
| result.reservationAcl.read | 사용자가 이 예약을 읽을 수 있는지 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.write | 연결된 예약의 사용자 쓰기 기능에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservationAcl.write.allFields | 사용자가 객체에 지정된 모든 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다 reservationACL.write.fields . 사용자가 일부 특정 필드에만 액세스할 수 있는 경우 해당 필드만 객체에서 reservationACL.write.fields true입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.write.fields | 예약의 다양한 필드에 대한 접근 통제에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservationAcl.write.fields.location | 사용자가 이 예약의 위치 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.write.fields.number_of_attendees | 사용자가 이 예약의 참석자 수 필드에 쓸 수 있는지 여부를 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.write.fields.requested_for | 사용자가 이 예약의 요청 대상 필드에 쓸 수 있는지 여부를 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.write.fields.sensitivity | 사용자가 이 예약의 민감도 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.write.fields.subject | 사용자가 이 예약의 제목 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.record | 사용자가 전체 예약 기록에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.standard_services | 매개 변수가 true로 설정된 경우에만 include_standard_services 채워집니다. 플립 차트, 프로젝터 화면, 화이트보드 및 마커와 같은 관련된 표준 서비스입니다. 데이터 형식: 객체 배열
|
| result.standard_services.font_awesome_icon | 표준 서비스와 연결된 썸네일 아이콘의 이름입니다. 데이터 유형: 문자열 |
| result.standard_services.name | 표준 서비스의 이름입니다. 데이터 유형: 문자열 |
| result.standard_services.short_description | 표준 서비스에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.standard_services.sys_id | 표준 서비스 기록의 Sys_id입니다. 표준 서비스[sn_wsd_rsv_standard_service] 테이블에 있습니다. 데이터 유형: 문자열 |
cURL 요청
다음 코드 예제에서는 이 끝점을 호출하고 표준 서비스 정보를 포함하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/get?sys_id=8e87c722870741106342b846dabb3573&include_standard_services=true" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
반환 결과:
"result": {
"reservation": {
"sys_id": "bf3621de842c2110fa9b813be354f327",
"number": "WRES0001005",
"location": {
"sys_id": "9841e94adb7210106c731dcd13961914",
"name": "A1-02-02",
"description": "General desk available for reservation.",
"display_value": "A1-02-02",
"capacity": 1,
"label_value": "Workspace/Desk name",
"wsd_email": null,
"reservable_module": {
"sys_id": "5db44502dbb650106c731dcd13961937",
"name": "Desks",
"title": "Desks",
"inline_title": "desk",
"table": "sn_wsd_core_space"
},
"region": {
"sys_id": "3752ac8edb3650106c731dcd139619e0",
"display_value": "Americas",
"active": true
},
"site": {
"sys_id": "628eec06db7650106c731dcd139619dd",
"display_value": "North America",
"active": true
},
"campus": {
"sys_id": "82b2a0cedb3650106c731dcd139619e9",
"display_value": "California Campus",
"active": true
},
"building": {
"sys_id": "94e264cedb3650106c731dcd13961919",
"display_value": "CAL-B1",
"active": true,
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"floor": {
"sys_id": "fc7368cedb3650106c731dcd13961902",
"display_value": "Floor 1",
"active": true
},
"area": {
"sys_id": "",
"display_value": "",
"active": false
},
"is_favorite": false,
"reservation": {
"sys_id": "bf3621de842c2110fa9b813be354f327",
"number_of_attendees": 1,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"auto_conflict_resolution_state": {
"value": null,
"display_value": null
},
"requested_for": {
"sys_id": "6816f79cc0a8016401c5a33be04be441",
"name": "System Administrator",
"user_name": "admin"
},
"number": "WRES0001005",
"active": true
},
"number_of_attendees": 1,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"number": "WRES0001005",
"requested_for": {
"sys_id": "6816f79cc0a8016401c5a33be04be441",
"name": "System Administrator",
"user_name": "admin"
},
"is_private": true
},
"start": "2023-01-24T16:00:00Z",
"end": "2023-01-24T17:00:00Z",
"sys_created_on": "2023-01-24T15:49:49Z",
"sys_updated_on": "2023-01-24T15:49:50Z",
"source_reservation": null,
"check_in_state": {
"value": "awaiting_check_in",
"display_value": "Awaiting check-in"
},
"external_id": null,
"external_ical": null,
"building": {
"active": true,
"sys_id": "94e264cedb3650106c731dcd13961919",
"display_value": "CAL-B1",
"campus": {
"display_value": "California Campus",
"value": "82b2a0cedb3650106c731dcd139619e9",
"active": true
},
"site": {
"display_value": "North America",
"value": "628eec06db7650106c731dcd139619dd",
"active": true
},
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"active": true,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"sensitivity": {
"value": "normal",
"display_value": "Normal"
},
"reservation_type": {
"value": "space",
"display_value": "Space"
},
"reservation_subtype": {
"value": "single",
"display_value": "Single"
},
"reservation_purpose": {
"value": "meeting",
"display_value": "Meeting"
},
"attendees": [
{
"sys_id": "6816f79cc0a8016401c5a33be04be441",
"value": "6816f79cc0a8016401c5a33be04be441",
"displayValue": "System Administrator",
"display_value": "System Administrator",
"name": "System Administrator",
"user_name": "admin",
"table": "sys_user",
"avatar": "a5d3c898c3222010ae17dd981840dd8b.iix?t=small",
"initials": "SA",
"email": "admin@example.com",
"label": "System Administrator, Finance"
}
],
"number_of_attendees": 1,
"is_parent": false,
"is_private": true,
"subject": "Reservation for A1-02-02",
"virtual_meeting": null,
"recording_details": [],
"sync_state": {
"value": "not_required",
"display_value": "Synchronization not required"
},
"sub_source": {
"value": "servicenow_workplace_service_delivery",
"display_value": "ServiceNow Workplace Service Delivery"
},
"last_updated_sub_source": {
"value": "servicenow_workplace_service_delivery",
"display_value": "ServiceNow Workplace Service Delivery"
},
"reservable_module": {
"sys_id": "5db44502dbb650106c731dcd13961937",
"name": "Desks",
"title": "Desks",
"inline_title": "desk",
"font_awesome_icon": "fa-desktop",
"reservable_table": "sn_wsd_core_space",
"reservable_filter": "active=true^is_reservable=true^location_type=5f017383eb512010b89bfdfc9c5228c8^building.is_reservable=true^floor.is_reservable=true^EQ",
"short_description": "Reserve a single desks",
"reservable_type": "location",
"require_subject": null,
"require_cancel_notes": false,
"virtual_meeting_provider": null,
"enable_reservation_privacy": true,
"allow_invitees": "1",
"display_number_of_attendees": null,
"display_on_behalf_of": "1",
"display_sensitivity": null,
"max_days_in_future": "90",
"allow_recurring": "1",
"auto_resolve_conflict": null,
"allow_whole_day": "1",
"allow_multi_building": "1",
"require_whole_day": null,
"selection_type": "unit",
"reservable_container_field": null,
"reservable_quantity_field": null,
"apply_to_shift": null,
"max_occurrences": "90",
"enable_facet_filter": false,
"search_limit": 10000,
"enable_ical_generation": null,
"enable_group_reservations": null,
"enable_browse_near_a_person": "1",
"enable_browse_by_area": "1",
"enable_floor_search": null,
"enable_browse_by_neighborhood": null,
"require_cc_dept_check": false,
"display_value": "Desks",
"browse_near_a_person_enabled": true,
"browse_by_area_enabled": true,
"browse_by_neighborhood_enabled": false,
"reservable_columns": [
"sys_id",
"external_id",
"wsd_email",
"name",
"title",
"description",
"image",
"number",
"site",
"campus",
"building",
"floor",
"area",
"capacity",
"reservable_quantity",
"location_type",
"order",
"requires_check_in",
"is_reservable"
],
"layout_mapping": {
"title": [
"name"
],
"description": [
"description"
],
"subtitle": [
"campus",
"building",
"floor",
"area"
],
"subtitle_asc": [
"area",
"floor",
"building",
"campus"
],
"image": "image",
"body": [
{
"label": "Capacity",
"icon": "fa-users",
"field": "capacity",
"field_to_display": ""
},
{
"label": "Standard services",
"icon": "fa-check",
"field": "standard_services",
"field_to_display": "name"
},
{
"label": "Reservable purposes",
"icon": "fa-tags",
"field": "reservable_purposes",
"field_to_display": "name"
}
]
},
"timeSlots": [
{
"sys_id": "d5331cf2dbb5f01038e42b24ca961906",
"name": "All day",
"short_description": "8am - 6pm",
"slot_start": "08:00",
"slot_end": "18:00"
},
{
"sys_id": "de131cf2dbb5f01038e42b24ca961931",
"name": "Before noon",
"short_description": "8am - 12pm",
"slot_start": "08:00",
"slot_end": "12:00"
},
{
"sys_id": "6e99ab5ddbb930102e8e853e68961929",
"name": "After noon",
"short_description": "1pm - 6pm",
"slot_start": "13:00",
"slot_end": "18:00"
}
],
"buildingSysIds": [
"03c45bf7dba41010d7981dcd1396196d",
"07c45bf7dba41010d7981dcd1396196b",
"07c45bf7dba41010d7981dcd13961972",
"0bc45bf7dba41010d7981dcd13961970",
"0fc45bf7dba41010d7981dcd1396196e",
"1aa39b1977220110b3d7be377b5a9953",
"2130659ae7321010809a268b03f6a91e",
"22c41bf7dba41010d7981dcd139619fe",
"2ac45bf7dba41010d7981dcd13961901",
"2ec41bf7dba41010d7981dcd139619ff",
"32c45bf7dba41010d7981dcd13961905",
"32c45bf7dba41010d7981dcd1396190c",
"32c45bf7dba41010d7981dcd13961943",
"e2c41bf7dba41010d7981dcd139619fb"
],
"reservable_views": [
{
"type": "card",
"label": "Card view",
"iconClass": "fa-th-large",
"isDefault": true,
"order": "1"
},
{
"type": "schedule",
"label": "Schedule view",
"iconClass": "fa-calendar-o",
"isDefault": false,
"order": "2"
}
],
"checkin_before_minutes": 30,
"reservation_paths": [
{
"value": "browse_all",
"displayValue": "Browse all",
"availableFor": true
},
{
"value": "browse_favorites",
"displayValue": "Browse favorites",
"availableFor": false
},
{
"value": "browse_near_a_person",
"displayValue": "Browse near a person",
"availableFor": true
},
{
"value": "browse_by_area",
"displayValue": "Browse by area",
"availableFor": true
}
],
"override_approval_policy": "never_required"
},
"notification_recipients": null,
"notification_custom_message": null,
"opened_by": {
"sys_id": "6816f79cc0a8016401c5a33be04be441",
"value": "6816f79cc0a8016401c5a33be04be441",
"displayValue": "System Administrator",
"display_value": "System Administrator",
"name": "System Administrator",
"user_name": "admin",
"table": "sys_user",
"avatar": "a5d3c898c3222010ae17dd981840dd8b.iix?t=small",
"initials": "SA",
"email": "admin@example.com",
"label": "System Administrator, Finance"
},
"requested_for": {
"sys_id": "6816f79cc0a8016401c5a33be04be441",
"value": "6816f79cc0a8016401c5a33be04be441",
"displayValue": "System Administrator",
"display_value": "System Administrator",
"name": "System Administrator",
"user_name": "admin",
"table": "sys_user",
"avatar": "a5d3c898c3222010ae17dd981840dd8b.iix?t=small",
"initials": "SA",
"email": "admin@example.com",
"label": "System Administrator, Finance"
},
"auto_conflict_resolution_state": {
"value": null,
"display_value": null
},
"parent_reservation": {},
"edit_restriction": {
"value": "no_restriction",
"display_value": "No restriction"
},
"source": {
"value": "servicenow",
"display_value": "Workplace Services"
},
"source_icon": {
"classNames": "fa fa-calendar-check-o",
"tooltip": "Reservation is confirmed",
"imgSrc": ""
},
"shift": null,
"hasPrivateReservation": true,
"reservationAcl": {
"write": {
"record": true,
"fields": {
"subject": true,
"sensitivity": true,
"requested_for": true,
"number_of_attendees": true,
"location": true,
"is_private": true
},
"allFields": true
},
"read": true
}
},
"reservationAcl": {
"write": {
"record": true,
"fields": {
"subject": true,
"sensitivity": true,
"requested_for": true,
"number_of_attendees": true,
"location": true,
"is_private": true
},
"allFields": true
},
"read": true
}
}
}
WSD 예약 - GET /api/sn_wsd_rsv/reservation/get_user_reservations
다음 7일 동안 지정된 사용자의 예약 목록을 조회합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/reservation/get_user_reservations
기본 URL: /api/sn_wsd_rsv/reservation/get_user_reservations
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| userID | 예약을 반환할 사용자의 Sys_id입니다. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 없음 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.
| 헤더 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, application/xml 또는, text/xml. 기본값: application/json |
| 헤더 | 설명 |
|---|---|
| 없음 |
상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| 결과 | 예약 반환 결과입니다. 데이터 유형: 객체 |
| result.informEmployeePrivacy | 비공개로 표시된 예약이 반환될 때 메시지를 표시할지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.reservationsByDate | 날짜별 각 예약에 대한 세부 정보입니다. 데이터 유형: 객체 - 자체 배열의 각 날짜 |
| result.reservationsByDate.building | 예약 가능한 건물이 있는 건물입니다. 이 정보는 건물 [sn_wsd_core_building] 테이블에 있습니다. |
| result.reservationsByDate.building.display_value | 건물의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservationsByDate.building.sys_id | 연결된 건물 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservationsByDate.building.timezone | 건물의 시간대에 대한 상세 정보입니다. |
| result.reservationsByDate.building.timezone.display_value | 연결된 건물이 있는 시간대의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservationsByDate.building.timezone.sys_id | 연결된 건물이 있는 시간대 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservationsByDate.building.value | 건물의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservationsByDate.floor | 예약과 관련된 층에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservationsByDate.floor.displayValue | 예약 가능한 항목이 있는 층의 번호를 표시합니다(예: 12). 데이터 유형: 문자열 |
| result.reservationsByDate.floor.value | 예약이 있는 층의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservationsByDate.location | 예약 위치에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservationsByDate.location.displayValue | 위치의 표시 값(예: 사우스 파크스)입니다. 데이터 유형: 문자열 |
| result.reservationsByDate.location.type | 위치 유형(예: 직장/책상, 카페 또는 체육관)입니다. 데이터 유형: 문자열 |
| result.reservationsByDate.location.value | 위치에 대한 내부 값(예: south_parks)입니다. 데이터 유형: 문자열 |
| result.searchEndDate | 예약 검색의 종료 날짜입니다. 시작 날짜로부터 7일 후입니다. 형식: yyyy-mm-dd 데이터 유형: 문자열 |
| result.searchStartDate | 예약 검색 시작 날짜입니다. 엔드포인트가 호출된 날짜입니다. 형식: yyyy-mm-dd 데이터 유형: 문자열 |
| result.sortedReservationDates | 지정된 사용자가 다음 7일 동안 예약하는 날짜를 날짜 순서로 정렬합니다. 데이터 유형: 배열 |
| result.workplaceProfile | 사용자 직장 프로필입니다. 지정된 사용자의 작업 위치를 설명합니다. 데이터 유형: 객체 |
| result.workplaceProfile.building | 사용자가 작업하는 건물입니다. 이 정보는 건물 [sn_wsd_core_building] 테이블에 있습니다. |
| result.workplaceProfile.building.display_value | 건물의 값을 표시합니다. 데이터 유형: 문자열 |
| result.workplaceProfile.building.sys_id | 연결된 건물 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.workplaceProfile.building.timezone | 건물의 시간대에 대한 상세 정보입니다. |
| result.workplaceProfile.building.timezone.display_value | 연결된 건물이 있는 시간대의 값을 표시합니다. 데이터 유형: 문자열 |
| result.workplaceProfile.building.timezone.sys_id | 연결된 건물이 있는 시간대 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| 결과.직장프로파일.건물.값 | 건물의 내부 값입니다. 데이터 유형: 문자열 |
| result.workplaceProfile.floor | 사용자가 작업하는 층에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.workplaceProfile.floor.displayValue | 8층과 같이 사용자가 근무하는 층의 번호를 표시합니다. 데이터 유형: 문자열 |
| result.workplaceProfile.floor.value | 사용자가 작업하는 층의 내부 값입니다. 데이터 유형: 문자열 |
| result.workplaceProfile.location | 사용자의 위치에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.workplaceProfile.location.displayValue | 샌디에고와 같은 위치의 값을 표시합니다. 데이터 유형: 문자열 |
| result.workplaceProfile.location.type | 사무실 또는 사무실과 같은 위치 유형입니다. 데이터 유형: 문자열 |
| 결과.워크플레이스프로파일.위치.값 | 위치에 대한 내부 값(예: san_diego)입니다. 데이터 유형: 문자열 |
cURL 요청
다음 코드 예제에서는 이 끝점을 호출하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/get_user_reservations?userId=2de07e1887cb89106342b846dabb35fe" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
반환 결과:
{
"result": {
"sortedReservationDates": [
"2023-01-24"
],
"workplaceProfile": {
"location": {
"displayValue": "DDC-A2.0016A",
"value": "96d3139977220110b3d7be377b5a9918",
"externalId": "0e7bddfb475a011064062782846d43c2",
"type": "Workspace/Desk"
},
"floor": {
"displayValue": "Floor 2",
"value": "68d31f5977220110b3d7be377b5a991b"
},
"building": {
"displayValue": "Building A",
"value": "dea39b1977220110b3d7be377b5a9955",
"timezone": {
"value": "Europe/Paris",
"displayValue": "Europe/Paris"
}
}
},
"reservationsByDate": {
"2023-01-24": [
{
"location": {
"displayValue": "A1-02-04",
"value": "3e41e94adb7210106c731dcd1396198c",
"externalId": "",
"type": "Workspace/Desk"
},
"floor": {
"displayValue": "Floor 1",
"value": "fc7368cedb3650106c731dcd13961902"
},
"building": {
"displayValue": "CAL-B1",
"value": "94e264cedb3650106c731dcd13961919",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
}
},
{
"location": {
"displayValue": "A1-02-02",
"value": "9841e94adb7210106c731dcd13961914",
"externalId": "",
"type": "Workspace/Desk"
},
"floor": {
"displayValue": "Floor 1",
"value": "fc7368cedb3650106c731dcd13961902"
},
"building": {
"displayValue": "CAL-B1",
"value": "94e264cedb3650106c731dcd13961919",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
}
},
{
"location": {
"displayValue": "A1-02-03",
"value": "fd41a94adb7210106c731dcd1396195a",
"externalId": "",
"type": "Workspace/Desk"
},
"floor": {
"displayValue": "Floor 1",
"value": "fc7368cedb3650106c731dcd13961902"
},
"building": {
"displayValue": "CAL-B1",
"value": "94e264cedb3650106c731dcd13961919",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
}
}
]
},
"searchStartDate": "2023-01-24",
"searchEndDate": "2023-01-31",
"informEmployeePrivacy": true
}
}
WSD 예약 - GET /api/sn_wsd_rsv/reservation/icalendar/{sys_id}
지정된 예약에 대한 iCalendar 파일 본문을 생성합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/reservation/icalendar/{sys_id}
기본 URL: /api/sn_wsd_rsv/reservation/icalendar/{sys_id}
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| sys_id | iCalendar 파일 본문을 생성할 예약의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 없음 |
| 이름 | 설명 |
|---|---|
| 없음 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.
| 헤더 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, application/xml 또는, text/xml. 기본값: application/json |
| 헤더 | 설명 |
|---|---|
| 없음 |
상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| 결과 | 지정된 예약에 대한 iCalendar 파일 본문입니다. 데이터 유형: 문자열 |
cURL 요청
다음 코드 예제에서는 이 끝점을 호출하여 iCalender 본문을 만드는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/icalendar/60d26a0f47578910003a4587746d4331" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
반환 결과:
{
"result": "BEGIN:VCALENDAR\nPRODID:-//Service-now.com//Outlook 11.0 MIMEDIR//EN\nVERSION:2.0\nMETHOD:REQUEST\nBEGIN:VEVENT\nATTENDEE;ROLE=REQ-PARTICIPANT;RSVP=TRUE:MAILTO:workplace_user@example.com\nDTSTART:20220521T050000Z\nDTEND:20220521T060000Z\nUID:60d26a0f47578910003a4587746d4331\nDTSTAMP:20220511T044018Z\nSUMMARY:For user 1\nDESCRIPTION:Dear System Administrator,\\n\\nThank you for your reservation.\\n\\nYou can find more details on your reservation, or manage your reservation using the following link: https://damay2.service-now.com/ws?id=wsd_reservation_summary&reservation_id=60d26a0f47578910003a4587746d4331\\n\\nKind regards,\\nWorkplace Services Team\nLOCATION:Berlin\nCLASS:PUBLIC\nORGANIZER;CN=Workplace User:MAILTO:workplace_user@example.com\nATTENDEE;ROLE=REQ-PARTICIPANT;CN=Workplace User:RSVP=TRUE:MAILTO:workplace_user@example.com\nEND:VEVENT\nEND:VCALENDAR"
}
WSD 예약 - GET /api/sn_wsd_rsv/reservation/list
지정된 사용자에게 속한 예약 목록을 조회합니다.
이 엔드포인트는 지정된 사용자가 요청했거나 지정한 사용자가 오픈한 예약만 반환합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/reservation/list
기본 URL: /api/sn_wsd_rsv/reservation/list
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| encodedQuery | 반환된 예약 기록 결과를 필터링하는 데 사용할 인코딩된 쿼리입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블 내의 모든 필드는 쿼리 내에서 유효합니다. 예: 데이터 유형: 문자열 |
| endIndex | 페이지 매김에 대한 인덱스를 지정할 때 반환할 결과 세트의 마지막 예약 기록입니다. 이 값이 사용 가능한 반환 결과 레코드 수보다 크면 나머지 레코드가 모두 반환됩니다. 데이터 유형: 숫자 |
| 순서ByEndDesc | 반환 결과를 시작 시간 내림차순으로 반환할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
기본값: false |
| 검색 기준 | 반환 결과에 포함하기 위해 예약 내에서 일치해야 하는 텍스트입니다. 엔드포인트는 다음 필드에서 이 값을 확인합니다.
데이터 유형: 문자열 |
| startIndex | 기록을 반환할 시작 기록이며 0부터 시작합니다. 이 매개 변수를 사용하여 큰 레코드 집합을 페이지 매김합니다. 데이터 유형: 문자열 기본값: 0 |
| userID | 반환된 예약 정보에서 필터링할 사용자의 Sys_id입니다. 사용자 [sys_user] 테이블에 있습니다. 이 값이 전달되면 엔드포인트는 requested_for 또는 opened_by 필드가 현재 로그인한 사용자와 동일한 예약을 필터링합니다. 그런 다음 해당 예약 목록에서 requested_for 또는 opened_by가 통과 userId한 예약을 필터링합니다. 데이터 유형: 문자열 기본값: requested_for 또는 opened_by 필드가 현재 로그인한 사용자와 동일한 모든 예약을 반환합니다. |
| 머리글 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, application/xml 또는, text/xml. 기본값: application/json |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.
| 헤더 | 설명 |
|---|---|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 헤더 | 설명 |
|---|---|
| 없음 |
상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| 결과.예약 | 예약에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.active | 예약이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| 결과.예약.참석자 | 예약 참석자 목록입니다. 데이터 형식: 객체 배열 |
| 결과.예약.참석자.아바타 | 참석자와 연결된 아바타의 Sys_id입니다. 첨부 파일 [sys_attachment] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.attendees.displayValue | 참석자의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservation.attendees.display_value | 참석자의 표시 값입니다. 와 displayValue동일합니다. 데이터 유형: 문자열 |
| result.reservation.attendees.email | 참석자의 이메일 주소입니다. 데이터 유형: 문자열 |
| 결과.예약.참석자.이니셜 | 참석자 이니셜 데이터 유형: 문자열 |
| result.reservation.attendees.name | 참석자 이름. 데이터 유형: 문자열 |
| result.reservation.attendees.sys_id | 참석자 기록을 Sys_id_of. 데이터 유형: 문자열 |
| 결과.예약.참석자.테이블 | 참석자 기록이 존재하는 테이블입니다. 데이터 유형: 문자열 |
| result.reservation.attendees.user_name | 참석자의 사용자 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.참석자.값 | 참석자의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservation.check_in_state | 예약의 체크인 상태에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.check_in_state.display_value | 진행 중 또는 완료와 같은 예약의 현재 체크인 상태에 대한 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.check_in_state.value | 예약의 현재 체크인 상태에 대한 내부 값(예: 2). 데이터 유형: 문자열 |
| result.reservation.edit_restriction | 예약에 대한 사용자 편집 제한에 대한 설명입니다(예: no_restrictions, service_only 또는 fully_restricted). 데이터 유형: 객체 |
| result.reservation.edit_restriction.display_value | 제한 없음과 같은 예약에 대한 편집 제한의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.edit_restriction.value | 예약에 대한 편집 제한의 내부 값( 예: no_restriction)입니다. 데이터 유형: 문자열 |
| 결과.예약.종료 | 예약 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| result.reservation.external_ical | 예약의 고유한 외부 iCalendar ID입니다. 달력 동기화 관련 예약인 경우 이 값을 사용하여 예약을 식별합니다. 데이터 유형: 문자열 |
| result.reservation.external_id | 예약의 고유한 외부 ID입니다. 달력 동기화 관련 예약인 경우 이 값을 사용하여 예약을 식별합니다. 데이터 유형: 문자열 |
| result.reservation.is_parent | 이 예약이 상위 예약인지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.reservation.is_private | 예약이 비공개인지 여부를 나타내는 플래그입니다. 비공개인 경우 예약은 소유자를 제외한 다른 사람에게 표시되지 않습니다. 이러한 개인 정보 설정에 대한 자세한 내용은 위치 개인 정보 보호 설정 및 영향을 참조하세요. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 기본값: 시스템 속성에서 개인정보 보호에 대해 설정된 값입니다. |
| result.reservation.last_updated_sub_source | 예약의 마지막으로 업데이트된 하위 소스에 대한 세부 정보입니다. 하위 소스는 예약을 외부 달력과 통합할 때 사용됩니다. 이 객체에는 "servicenow_workplace_service_delivery", "google_calendar" 또는 "microsoft_exchange"와 같은 정보가 포함됩니다. 데이터 유형: 객체 |
| result.reservation.last_updated_sub_source.display_value | ServiceNow 워크플레이스 서비스 제공 또는 Google 달력과 같은 예약의 마지막으로 업데이트된 하위 소스에 대한 값을 표시합니다. 예약을 Google 캘린더 또는 Microsoft Outlook과 같은 외부 서비스와 통합할 때 사용됩니다. 데이터 유형: 문자열 |
| result.reservation.last_updated_sub_source.값 | 예약의 마지막으로 업데이트된 하위 소스에 대한 내부 값입니다(예: servicenow_workplace_service_delivery 또는 google_calendar). 예약을 Google 캘린더 또는 Microsoft Outlook과 같은 외부 서비스와 통합할 때 사용됩니다. 데이터 유형: 문자열 |
| 결과.예약.위치 | 예약과 관련된 위치에 대한 세부 정보입니다. 데이터 유형: 객체 |
| 결과.예약.위치.지역 | 위치와 연결된 영역에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.area.active | 영역이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.area.display_value | 이 위치가 속한 영역의 값을 표시합니다(예: 책상 A2). 데이터 유형: 문자열 |
| result.reservation.location.area.sys_id | 이 위치가 속한 지역의 Sys_id입니다. 영역 [sn_wsd_core_area] 테이블에 있습니다. 데이터 유형: 문자열 |
| 결과.예약.위치.건물 | 위치와 연결된 건물에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.building.active | 건물이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.building.display_value | 이 위치가 속한 건물의 값을 표시합니다(예: AMS - 빌딩1). 데이터 유형: 문자열 |
| result.reservation.location.building.sys_id | 이 위치가 속한 건물의 Sys_id입니다. 건물 [sn_wsd_core_building] 테이블에 있습니다. 데이터 유형: 문자열 |
| 결과.예약.위치.건물.시간대 | 위치와 연결된 시간대에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.building.timezone.display_value | 이 위치가 속한 시간대의 값을 표시합니다. 데이터 유형: 문자열 |
| 결과.예약.위치.건물.시간대.값 | 이 위치가 속한 시간대의 내부 값입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.캠퍼스 | 위치와 관련된 캠퍼스에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.campus.active | 캠퍼스가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.campus.display_value | 암스테르담 캠퍼스 등 이 위치가 속한 캠퍼스의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.location.campus.sys_id | 이 위치가 속한 캠퍼스의 Sys_id입니다. 캠퍼스 [sn_wsd_core_campus] 테이블에 있습니다. 데이터 유형: 문자열 |
| 결과.예약.위치.용량 | 해당 위치의 최대 점유자 수입니다. 데이터 유형: 숫자 |
| 결과.예약.위치.설명 | 위치에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservation.location.display_value | 이 위치의 UI에 표시할 값입니다. 데이터 유형: 문자열 |
| result.reservation.location.email | 위치의 이메일 주소입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.층 | 위치와 연결된 층에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.floor.active | 층이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.floor.display_value | 이 위치가 속한 층의 값을 표시합니다(예: 1층). 데이터 유형: 문자열 |
| result.reservation.location.floor.sys_id | 이 위치가 속한 층의 Sys_id입니다. 층 [sn_wsd_core_floor] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.location.label_value | 매개변수에 name 지정된 값의 유형입니다(예: 방 이름). 데이터 유형: 문자열 |
| result.reservation.location.name | 위치 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.번호 | 예약 번호입니다. 데이터 유형: 문자열 |
| result.reservation.location.number_of_attendees | 예약 참석자 수입니다. 데이터 유형: 숫자 |
| 결과.예약.위치.지역 | 위치와 연결된 지역에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.region.active | 지역이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.region.display_value | 이 위치가 속한 지역의 값(예: 유럽)을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.location.region.sys_id | 이 위치가 속한 지역의 Sys_id입니다. 지역 [sn_wsd_core_region] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.location.requested_for | 대신 예약을 요청한 사람에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.requested_for.이름 | 예약을 요청한 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.location.requested_for.sys_id | 예약이 요청되는 사용자의 Sys_id입니다. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.location.requested_for.user_name | 예약을 요청한 사용자의 사용자 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.예약 | 위치와 관련된 예약에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.reservation.active | 예약이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| 결과.예약.위치.예약.번호 | 예약 번호입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservation.number_of_attendees | 예약 참석자 수입니다. 데이터 유형: 숫자 |
| result.reservation.location.reservation.requested_for | 대신 예약을 요청한 사람에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.reservation.requested_for.이름 | 예약을 요청한 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservation.requested_for.sys_id | 요청 대상 사용자의 Sys_id입니다. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.location.reservation.requested_for.사용자_이름 | 예약을 요청한 사용자의 사용자 이름입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservable_module | 예약과 관련된 예약 가능한 모듈에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.reservable_module.inline_title | 예약 가능한 모듈의 인라인 제목입니다. 제목은 직장 서비스 포털의 설명 텍스트와 나란히 표시됩니다. 데이터 유형: 문자열 |
| result.reservation.location.reservable_module.이름 | 예약 가능한 모듈의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservable_module.sys_id | 예약 가능한 모듈의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservable_module.타이틀 | 예약 가능한 모듈의 제목입니다. 데이터 유형: 문자열 |
| result.reservation.location.site | 위치가 속한 사이트입니다. 사이트 [sn_wsd_core_site] 테이블에 있습니다. 데이터 유형: 객체 |
| result.reservation.location.site.active | 사이트가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.site.display_value | 이 위치가 속한 사이트의 값 표시입니다(예: 서유럽). 데이터 유형: 문자열 |
| result.reservation.location.site.sys_id | 이 위치가 속한 사이트의 Sys_id입니다. 사이트 [sn_wsd_core_site] 테이블에 있습니다. 데이터 유형: 문자열 |
| 결과.예약.위치.상태 | 위치의 예약 상태에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.state.display_value | 예약의 현재 상태에 대한 값을 표시합니다(예: 확인됨). 데이터 유형: 문자열 |
| 결과.예약.위치.상태.값 | 예약의 현재 상태에 대한 내부 값(예: 2)입니다. 데이터 유형: 문자열 |
| result.reservation.location.sys_id | 연결된 위치 기록의 Sys_id입니다. 직장 위치[sn_wsd_core_workplace_location] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.notification_custom_message | 에 나열된 수신자에게 전송되는 알림에 대한 사용자 지정 메시지입니다 reservation.notification_recipients. 데이터 유형: 문자열 |
| result.reservation.notification_recipients | 예약에 대한 알림을 받는 수신자 목록입니다. 데이터 형식: 객체 배열 |
| result.reservation.notification_recipients.name | 수신자의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.notification_recipients.sys_id | 수신자의 Sys_id입니다. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.notification_recipients.user_name | 수신자의 사용자 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.번호 | 예약 기록의 고유 번호입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 이 값을 사용하여 예약을 쿼리할 수 있습니다. 데이터 유형: 문자열 |
| result.reservation.opened_by | 예약을 생성한 사용자에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.opened_by.아바타 | 예약을 연 사용자의 아바타입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.displayValue | 사용자가 연 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.display_value | 사용자가 연 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.email | 예약을 연 사용자의 이메일 주소입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.이니셜 | 예약을 오픈한 사용자의 이니셜입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.레이블 | 예약을 오픈한 사용자의 레이블입니다. 사용자의 직함과 부서를 조합한 것입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.name | 예약을 연 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.rservation.opened_by.sys_id | 예약을 오픈한 사용자를 Sys_id_of. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.rservation.opened_by.테이블 | 사용자 기록이 포함된 테이블입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.사용자_이름 | 예약을 연 사용자의 사용자 이름입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.value | 예약을 연 사용자의 내부 값입니다. 데이터 유형: 문자열 |
| 결과.예약.번호 | 예약 번호입니다. 데이터 유형: 문자열 |
| result.reservation.number_of_attendees | 이 예약의 참석자 수입니다. 데이터 유형: number |
| result.reservation.recording_details | 예약(회의)과 관련된 녹화에 대한 상세 정보입니다. 데이터 유형: 배열 |
| result.reservation.recording_details.recording_url | 예약과 관련된 기록의 URL입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for | 대신 예약한 사용자에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.requested_for.아바타 | 대신 예약한 사용자의 아바타입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.displayValue | 대신 예약한 사용자의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.display_value | 대신 예약한 사용자의 값을 표시합니다. 와 displayValue동일합니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.email | 대신 예약한 사용자의 이메일 주소입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.이니셜 | 대신 예약한 사용자의 이니셜입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.레이블 | 대신 예약한 사용자의 레이블입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.name | 대신 예약한 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.rservation.requested_for.sys_id | 대신 예약한 사용자를 Sys_id_of. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.rservation.requested_for.테이블 | 사용자 기록이 포함된 테이블입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.사용자_이름 | 대신 예약한 사용자의 사용자 이름입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.value | 대신 예약이 이루어진 사용자의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module | 요청된 예약 가능한 모듈에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservable_module.allow_invitees | 직원이 예약에 초대를 추가할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.allow_whole_day | 사용자가 하루 종일 예약 가능한 항목을 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.apply_to_shift | 예약 가능한 모듈에 대해 교대조 기반 예약이 활성화되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.browse_by_area_enabled | 사용자가 영역별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.browse_near_a_person_enabled | 사용자가 지정된 사람이 찾은 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.buildingSysIds | 예약 가능한 모듈과 연결된 건물 sys_ids 목록입니다. 데이터 형식: 문자열 배열 |
| result.reservation.reservable_module.checkin_before_minutes | 예약이 시작되기 전에 사용자가 예약에 체크인할 수 있는 시간입니다. 단위: 분 데이터 유형: 숫자 |
| result.reservation.reservable_module.display_number_of_attendees | 사용자가 예약의 참석자 수를 지정할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.display_on_behalf_of | 다른 사람을 대신하여 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.display_sensitivity | 사용자가 예약의 민감도(예: 일반 또는 비공개)를 설정할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.display_value | 예약 가능한 모듈의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.enable_browse_by_area | 사용자가 영역별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 와 browse_by_area_enabled동일합니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.enable_browse_near_a_person | 사용자가 지정된 사람이 찾은 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 와 browse_near_a_person_enabled 같습니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.enable_facet_filter | 작업장 항목에 대한 패싯 필터링이 활성화되어 있는지 여부를 나타내는 플래그입니다. 이 옵션을 사용하면 표시되는 필터 옵션은 검색 결과를 기반으로 합니다. 사용자는 생성된 검색 결과에서 사용할 수 있는 항목만 필터에서 선택할 수 있습니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.enable_group_reservations | 사용자가 그룹을 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.enable_ical_generation | 사용자가 예약에 대한 iCalendar를 생성할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.font_awesome_icon | 예약 가능한 모듈에 연결된 글꼴 아이콘의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.inline_title | 예약 가능한 모듈의 인라인 제목입니다. 제목은 직장 서비스 포털의 설명 텍스트와 나란히 표시됩니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping | 위치의 레이아웃 매핑 구조에 대한 상세 정보입니다. 이 데이터를 사용하여 UI에 정보를 배치합니다. 데이터 유형: 객체 |
| result.reservation.reservable_module.layout_mapping.본문 | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 형식: 객체 배열 |
| result.reservation.reservable_module.layout_mapping.body.field | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.body.field_to_display입니다. | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.body.icon | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.body.label | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.설명 | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 레이아웃 매핑에 대한 설명입니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.layout_mapping.이미지 | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.부제목 | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.layout_mapping.subtitle_asc | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.layout_mapping.제목 | 프런트 엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.max_days_in_future | 사용자가 예약 가능한 모듈을 예약할 수 있는 미래의 최대 일수입니다. 데이터 유형: 숫자 |
| result.reservation.reservable_module.max_occurrences | 예약 가능한 모듈에 반복 예약을 사용할 수 있는 경우 반복 예약 발생의 최대 수입니다. 데이터 유형: 숫자 |
| result.reservation.reservable_module.name | 예약 가능한 모듈의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.override_approval_policy | 승인 정책을 구현하는 방법을 지정하는 옵션입니다. 선택 사항은 다음과 같습니다.
데이터 유형: 문자열 |
| result.reservation.reservable_module.require_cancel_notes | 예약 가능한 모듈을 취소하기 전에 사용자가 취소 메모를 입력해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.require_cc_dept_check | 작업 공간 항목과 로그인한 사용자 간에 비용 센터 또는 부서 불일치가 있는지 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.require_subject | 예약 시 사용자가 제목을 입력해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.reservable_columns | 예약 가능한 열의 목록입니다. 직장 위치[sn_wsd_core_workplace_location] 테이블에 있습니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.reservable_container_field | 컨테이너의 수준입니다(예: 특정 영역의 책상 그룹). 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_filter | 연결된 예약 가능한 테이블에서 예약 가능한 항목을 필터링하는 데 사용되는 필터 조건입니다. 예약 가능한 테이블은 예약 가능한 모듈 [sn_wsd_rsv_reservable_module] 테이블의 필드입니다. 이러한 필터 조건은 필드 예약 가능한 테이블에 포함된 테이블에 적용되었습니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_quantity_field | 모든 공간의 예약 가능한 수량입니다. 이 수량은 영역에 인접 공간을 할당할 때 사용됩니다. 자세한 내용은 영역에 인접 공간 할당을 참고하세요. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_table | 예약 가능한 직장 항목을 포함하는 테이블입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_type | 위치와 같은 예약 가능한 항목의 유형입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_views | 카드 뷰 또는 일정 뷰와 같이 예약 가능한 모듈과 연결된 다양한 뷰에 대한 상세 정보입니다. 예약 가능한 뷰 [sn_wsd_rsv_reservable_view] 테이블에 있습니다. 데이터 유형: 객체 |
| result.reservation.reservable_module.reservable_views.icon클래스 | 예약 가능한 뷰의 아이콘 클래스입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_views.isDefault | 이 예약 가능한 뷰를 예약 가능한 모듈의 기본값으로 설정할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.reservable_views.레이블 | 예약 가능한 뷰의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_views.주문 | UI에서 예약 가능한 모듈에 대한 뷰가 표시되는 순서입니다. UI에서 순서 번호가 낮을수록 먼저 표시됩니다. 동일한 주문 번호의 경우 무작위 순서가 할당됩니다. 데이터 유형: 숫자 |
| result.reservation.reservable_module.reservable_views.type | 예약 가능한 뷰의 백엔드 이름입니다. 내부 처리에 사용됩니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservation_paths | 모두 찾아보기, 사람 근처 탐색 등 예약 가능한 모듈과 연결된 예약 경로입니다. 데이터 형식: 객체 배열 |
| result.reservation.reservable_module.reservation_paths.display_value | 예약 경로에 대한 값을 표시합니다(예: "사람 근처 탐색"). 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservation_paths.값 | 예약 경로의 내부 값(예: "browse_near_a_person")입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.search_limit | 사용자가 직장 위치를 검색할 때 반환할 최대 검색 결과 수입니다. 데이터 유형: 숫자 |
| result.reservation.reservable_module.selection_type | 검색 결과에 표시할 선택 유형입니다. 다음 옵션 중 하나일 수 있습니다.
데이터 유형: 문자열 |
| result.reservation.reservable_module.short_description | 예약 가능한 모듈에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.show_map_view | 예약 가능한 모듈에 대해 맵 뷰를 사용할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.sys_id | 예약 가능한 모듈의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots | 예약 가능한 모듈에 연결된 시간 슬롯에 대한 상세 정보입니다. 데이터 형식: 객체 배열 |
| result.reservation.reservable_module.timeSlots.name | 시간 슬롯의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots.short_description | 타임 슬롯에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots.slot_end | 시간 슬롯의 종료 시간입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots.slot_start | 슬롯의 시작 시간입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots.sys_id | 시간 슬롯 기록의 Sys_id입니다. 시간 슬롯 [sn_wsd_rsv_time_slot] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.제목 | 예약 가능한 모듈의 제목입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.virtual_meeting_provider | 예약 가능한 모듈과 연결된 가상 제공자에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservable_module.virtual_meeting_provider.display_value | 가상 회의 제공자의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.virtual_meeting_provider.sys_id | 가상 회의 공급자의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservation.reservationAcl | 연결된 예약에 설정된 사용자 접근 제어 수준(ACL) 검사의 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservationAcl.read | 사용자가 이 예약을 읽을 수 있는지 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write | 연결된 예약의 사용자 쓰기 기능에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservationAcl.write.allFields | 사용자가 객체에 지정된 모든 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다 reservationACL.write.fields . 사용자가 일부 특정 필드에만 액세스할 수 있는 경우 해당 필드만 객체에서 reservationACL.write.fields true입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields | 예약의 다양한 필드에 대한 접근 통제에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservationAcl.write.fields.location | 사용자가 이 예약의 위치 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields.number_of_attendees | 사용자가 이 예약의 참석자 수 필드에 쓸 수 있는지 여부를 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields.requested_for | 사용자가 이 예약의 요청 대상 필드에 쓸 수 있는지 여부를 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields.sensitivity | 사용자가 이 예약의 민감도 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields.subject | 사용자가 이 예약의 제목 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.record | 사용자가 전체 예약 기록에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservation_purpose | 예약 목적에 대한 자세한 내용입니다. 데이터 유형: 객체 |
| result.reservation.reservation_purpose.display_value | 회사 회의와 같은 예약 목적의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservation_purpose.value | 예약의 목적에 대한 내부 값입니다(예: company_meeting). 데이터 유형: 문자열 |
| result.reservation.reservation_type | 예약 유형에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservation_type.display_value | 공간과 같은 예약 유형에 대한 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservation_type.value | 공간과 같은 예약 유형에 대한 내부 값입니다. 데이터 유형: 문자열 |
| result.reservation.reservation_subtype | 예약의 하위 유형에 대한 세부 정보입니다. 하위 유형은 예약 유형(예: 단일, 다중 상위, 다중 하위, 반복 상위 또는 발생)을 나타냅니다. 데이터 유형: 객체 |
| result.reservation.reservation_subtype.display_value | 예약 하위 유형(예: 단일)에 대한 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservation_subtype.값 | 예약 하위 유형에 대한 내부 값입니다(예: 단일). 데이터 유형: 문자열 |
| 결과.예약.민감도 | 예약의 민감도에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.sensitivity.display_value | 예약 민감도의 표시 값(예: 높음 또는 낮음)입니다. 데이터 유형: 문자열 |
| 결과.예약.민감도.값 | 예약의 민감도에 대한 내부 값(예: 1 또는 3)입니다. 데이터 유형: 문자열 |
| 결과.예약.교대조 | 예약에 적용된 교대조에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.shift.display_value | 교대조의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.shift.name | 교대조의 이름입니다. 와 display_value동일합니다. 데이터 유형: 문자열 |
| 결과.예약.교대조.교대조 상세 정보 | 교대조의 상세 정보입니다. 데이터 유형: 문자열 |
| result.reservation.shift.sys_id | 교대조 기록의 Sys_id입니다. 교대조 [sn_wsd_core_shift] 테이블에 있습니다. 데이터 유형: 문자열 |
| 결과.예약.소스 | 예약 소스에 대한 상세 정보(예: 직장 서비스 또는 Google Mail)입니다. 데이터 유형: 객체 |
| result.reservation.source.display_value | 직장 서비스와 같은 예약 소스의 값을 표시합니다. 데이터 유형: 문자열 |
| 결과.예약.소스.값 | 예약 소스의 내부 값입니다(예: ServiceNow). 데이터 유형: 문자열 |
| result.reservation.source_icon | 예약에 사용된 아이콘의 소스에 대한 세부 정보입니다. 이 아이콘은 UI에서 사용됩니다. 데이터 유형: 객체 |
| result.reservation.source_icon.클래스 이름 | 소스 아이콘의 클래스 이름(쉼표로 구분됨). 데이터 유형: 문자열 |
| result.reservation.source_icon.imgSrc | 소스 아이콘에 대한 이미지 소스의 이름입니다. 이 아이콘은 이미지 [db_image] 테이블에 저장됩니다. 데이터 유형: 문자열 |
| result.reservation.source_icon.tooltip | 소스 아이콘에 연결된 도구 설명입니다. 데이터 유형: 문자열 |
| result.reservation.source_reservation | 현재 예약의 소스 예약입니다. 예를 들어 여러 예약의 경우 상위 예약이 하위 예약의 소스입니다. 데이터 유형: 문자열 |
| 결과.예약.시작 | 예약 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| 결과.예약.제목 | 예약의 주제입니다. 데이터 유형: 문자열 |
| result.reservation.sub_source | 예약의 하위 소스에 대한 세부 정보입니다. 하위 소스는 예약이 시작된 위치(예: Google 캘린더 또는 Microsoft Exchange)를 지정합니다. 데이터 유형: 객체 |
| result.reservation.sub_source.display_value | Google 달력과 같은 예약의 하위 소스에 대한 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.sub_source.value | 예약의 하위 소스 필드에 대한 내부 값입니다(예: google_calendar). 데이터 유형: 문자열 |
| result.reservation.sync_state | "sync_enqueued" 또는 "동기화됨"과 같은 다른 서비스의 예약 동기화 상태에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.sync_state.display_value | 예약의 현재 동기화 상태에 대한 값(예: 동기화됨)을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.sync_state.value | 예약의 현재 동기화 상태의 내부 값(예: 동기화됨)입니다. 데이터 유형: 문자열 |
| result.reservation.sys_created_on | 예약이 생성된 날짜 및 시간입니다. 데이터 유형: 문자열 |
| result.reservation.sys_id | 필수 예약 기록의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 데이터 유형: 문자열 |
| Result.reservation.sys_updated_on | 예약이 마지막으로 업데이트된 날짜 및 시간입니다. 데이터 유형: 문자열 |
| result.reservation.virtual_meeting | 가상 회의 링크의 URL입니다. 데이터 유형: 문자열 |
| result.reservationAcl | 연결된 예약에 설정된 사용자 접근 제어 수준(ACL) 검사의 상세 정보입니다. 데이터 유형: 객체 |
| result.reservationAcl.read | 사용자가 이 예약을 읽을 수 있는지 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.write | 연결된 예약의 사용자 쓰기 기능에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservationAcl.write.allFields | 사용자가 객체에 지정된 모든 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다 reservationACL.write.fields . 사용자가 일부 특정 필드에만 액세스할 수 있는 경우 해당 필드만 객체에서 reservationACL.write.fields true입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.write.fields | 예약의 다양한 필드에 대한 접근 통제에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservationAcl.write.fields.location | 사용자가 이 예약의 위치 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.write.fields.number_of_attendees | 사용자가 이 예약의 참석자 수 필드에 쓸 수 있는지 여부를 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.write.fields.requested_for | 사용자가 이 예약의 요청 대상 필드에 쓸 수 있는지 여부를 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.write.fields.sensitivity | 사용자가 이 예약의 민감도 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.write.fields.subject | 사용자가 이 예약의 제목 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservationAcl.record | 사용자가 전체 예약 기록에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.standard_services | 매개 변수가 true로 설정된 경우에만 include_standard_services 채워집니다. 플립 차트, 프로젝터 화면, 화이트보드 및 마커와 같은 관련된 표준 서비스입니다. 데이터 형식: 객체 배열
|
| result.standard_services.font_awesome_icon | 표준 서비스와 연결된 썸네일 아이콘의 이름입니다. 데이터 유형: 문자열 |
| result.standard_services.name | 표준 서비스의 이름입니다. 데이터 유형: 문자열 |
| result.standard_services.short_description | 표준 서비스에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.standard_services.sys_id | 표준 서비스 기록의 Sys_id입니다. 표준 서비스[sn_wsd_rsv_standard_service] 테이블에 있습니다. 데이터 유형: 문자열 |
cURL 요청
이 코드 예제에서는 이 엔드포인트를 호출하여 지정된 사용자와 연결된 예약 목록을 검색하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/list" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
반환 결과:
{
"result": {
"reservations": [
{
"sys_id": "12e2da5e87c701106342b846dabb354d",
"number": "WRES0001010",
"location": {
"sys_id": "02000d4edb7650106c731dcd13961914",
"name": "Eureka",
"description": "A comfortable meeting room with leather chairs and a wooden table. Client meeting room.",
"display_value": "Eureka",
"capacity": 12,
"label_value": "Room name",
"email": "eureka@example.com",
"reservable_module": {
"sys_id": "c31241cedb7650106c731dcd13961917",
"name": "Meeting rooms",
"title": "Meeting rooms",
"inline_title": "meeting room"
},
"region": {
"sys_id": "2d626c4edb3650106c731dcd1396194b",
"display_value": "Europe",
"active": true
},
"site": {
"sys_id": "b17220cedb3650106c731dcd1396197a",
"display_value": "Western Europe",
"active": true
},
"campus": {
"sys_id": "44d2e0cedb3650106c731dcd13961988",
"display_value": "Amsterdam Campus",
"active": true
},
"building": {
"sys_id": "9e0364cedb3650106c731dcd1396192b",
"display_value": "AMS-B1",
"active": true,
"timezone": {
"value": "Europe/Amsterdam",
"displayValue": "Europe/Amsterdam"
}
},
"floor": {
"sys_id": "5373a8cedb3650106c731dcd1396198a",
"display_value": "Floor 3",
"active": true
},
"area": {
"sys_id": "",
"display_value": "",
"active": false
},
"reservation": {
"sys_id": "12e2da5e87c701106342b846dabb354d",
"number_of_attendees": 1,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"name": "Workplace User",
"user_name": "workplace_user"
},
"number": "WRES0001010",
"active": true
},
"number_of_attendees": 1,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"number": "WRES0001010",
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"name": "Workplace User",
"user_name": "workplace_user"
}
},
"start": "2022-05-15T16:00:00Z",
"end": "2022-05-15T17:00:00Z",
"sys_created_on": "2022-04-26T09:19:37Z",
"sys_updated_on": "2022-04-26T09:20:04Z",
"source_reservation": null,
"check_in_state": {
"value": "not_required",
"display_value": "Not required"
},
"external_id": null,
"external_ical": null,
"active": true,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"sensitivity": {
"value": "normal",
"display_value": "Normal"
},
"reservation_type": {
"value": "space",
"display_value": "Space"
},
"reservation_subtype": {
"value": "single",
"display_value": "Single"
},
"reservation_purpose": {
"value": "meeting",
"display_value": "Meeting"
},
"attendees": [
{
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"value": "2de07e1887cb89106342b846dabb35fe",
"displayValue": "Workplace User",
"display_value": "Workplace User",
"name": "Workplace User",
"user_name": "workplace_user",
"table": "sys_user",
"avatar": "eb513744c3222010ae17dd981840dd97",
"initials": "WU",
"email": "workplace_user@example.com",
"label": ""
}
],
"number_of_attendees": 1,
"is_parent": false,
"subject": "Add rsv_1",
"virtual_meeting": "https://samplemeetingurl.com",
"recording_details": [
{
"recording_url": "https://samplerecordingurl.com"
}
],
"sync_state": {
"value": "not_required",
"display_value": "Synchronization not required"
},
"sub_source": {
"value": "servicenow_workplace_service_delivery",
"display_value": "ServiceNow Workplace Service Delivery"
},
"last_updated_sub_source": {
"value": "servicenow_workplace_service_delivery",
"display_value": "ServiceNow Workplace Service Delivery"
},
"reservable_module": {
"sys_id": "c31241cedb7650106c731dcd13961917",
"name": "Meeting rooms",
"title": "Meeting rooms",
"inline_title": "meeting room",
"font_awesome_icon": "fa-building",
"reservable_table": "sn_wsd_core_room",
"reservable_filter": "active=true^is_reservable=true^building!=6c0364cedb3650106c731dcd13961927^building.is_reservable=true^floor.is_reservable=true^EQ",
"short_description": "Reserve a meeting room",
"reservable_type": "location",
"require_subject": "1",
"require_cancel_notes": true,
"virtual_meeting_provider": {
"sys_id": "e33d9e6853c201103cf7ddeeff7b1205",
"display_value": "Template"
},
"allow_invitees": "1",
"display_number_of_attendees": "1",
"display_on_behalf_of": "1",
"display_sensitivity": "1",
"max_days_in_future": "180",
"allow_whole_day": "1",
"selection_type": "unit",
"reservable_container_field": null,
"reservable_quantity_field": null,
"apply_to_shift": null,
"max_occurrences": "180",
"enable_facet_filter": false,
"search_limit": 10000,
"enable_ical_generation": null,
"enable_group_reservations": null,
"enable_browse_near_a_person": "1",
"enable_browse_by_area": "1",
"display_value": "Meeting rooms",
"browse_near_a_person_enabled": true,
"browse_by_area_enabled": true,
"reservable_columns": [
"sys_id",
"external_id",
"email",
"name",
"title",
"description",
"image",
"number",
"site",
"campus",
"building",
"floor",
"area",
"capacity",
"reservable_quantity",
"location_type",
"order",
"requires_check_in",
"is_reservable"
],
"layout_mapping": {
"title": [
"name"
],
"description": [
"description"
],
"subtitle": [
"campus",
"building",
"floor",
"area"
],
"subtitle_asc": [
"area",
"floor",
"building",
"campus"
],
"image": "image",
"body": [
{
"label": "Capacity",
"icon": "fa-users",
"field": "capacity",
"field_to_display": ""
},
{
"label": "Standard services",
"icon": "fa-check",
"field": "standard_services",
"field_to_display": "name"
},
{
"label": "Reservable purposes",
"icon": "fa-tags",
"field": "reservable_purposes",
"field_to_display": "name"
}
]
},
"timeSlots": [
{
"sys_id": "d5331cf2dbb5f01038e42b24ca961906",
"name": "All day",
"short_description": "8am - 6pm",
"slot_start": "08:00",
"slot_end": "18:00"
}
],
"buildingSysIds": [
"4703a4cedb3650106c731dcd13961945",
"6c0364cedb3650106c731dcd13961927",
"94e264cedb3650106c731dcd13961919",
"9e0364cedb3650106c731dcd1396192b"
],
"reservable_views": [
{
"type": "card",
"label": "Card view",
"iconClass": "fa-th-large",
"isDefault": true,
"order": "1"
},
{
"type": "schedule",
"label": "Schedule view",
"iconClass": "fa-calendar-o",
"isDefault": false,
"order": "2"
}
],
"checkin_before_minutes": 30,
"reservation_paths": [
{
"value": "browse_all",
"displayValue": "Browse all"
},
{
"value": "browse_near_a_person",
"displayValue": "Browse near a person"
},
{
"value": "browse_by_area",
"displayValue": "Browse by area"
}
],
"override_approval_policy": "never_required"
},
"notification_recipients": [
{
"sys_id": "7016f79cc0a8016401c5a33be04be441",
"name": "workplace user",
"user_name": "workplace.user"
}
],
"notification_custom_message": "Demo notification message",
"opened_by": {
"sys_id": "6816f79cc0a8016401c5a33be04be441",
"value": "6816f79cc0a8016401c5a33be04be441",
"displayValue": "System Administrator",
"display_value": "System Administrator",
"name": "System Administrator",
"user_name": "admin",
"table": "sys_user",
"avatar": "eb513744c3222010ae17dd981840dd97",
"initials": "SA",
"email": "admin@example.com",
"label": "System Administrator"
},
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"value": "2de07e1887cb89106342b846dabb35fe",
"displayValue": "Workplace User",
"display_value": "Workplace User",
"name": "Workplace User",
"user_name": "workplace_user",
"table": "sys_user",
"avatar": "d3513744c3222010ae17dd981840dd97",
"initials": "WU",
"email": "workplace_user@example.com",
"label": ""
},
"edit_restriction": {
"value": "no_restriction",
"display_value": "No restriction"
},
"source": {
"value": "servicenow",
"display_value": "Workplace Services"
},
"source_icon": {
"classNames": "fa fa-calendar-check-o",
"tooltip": "Reservation is confirmed",
"imgSrc": ""
},
"shift": {
"sys_id": "e5d23acfdb42a01097acc9003996193a",
"name": "Test shift AMS-B1",
"display_value": "Test shift AMS-B1",
"shiftDetails": "8-5 weekdays excluding holidays\n - Monday-Friday 8-5"
},
"reservationAcl": {
"write": {
"record": true,
"fields": {
"subject": true,
"sensitivity": true,
"requested_for": true,
"number_of_attendees": true,
"location": true
},
"allFields": true
},
"read": true
}
}
]
}
}
WSD 예약 - PATCH /api/sn_wsd_rsv/reservation/cancel/{sys_id}
지정된 직장 예약을 취소합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/reservation/cancel/{sys_id}
기본 URL: /api/sn_wsd_rsv/reservation/cancel/{sys_id}
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| sys_id | 취소할 예약의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 없음 |
| 이름 | 설명 |
|---|---|
| cancel_notes | 예약 취소 사유입니다. 데이터 유형: 문자열 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.
| 헤더 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, application/xml 또는, text/xml. 기본값: application/json |
| 컨텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 헤더 | 설명 |
|---|---|
| 없음 |
상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| sys_id | 취소된 예약 기록의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 데이터 유형: 문자열 |
cURL 요청
다음 코드 예제에서는 이 엔드포인트를 사용하여 예약을 취소하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/cancel/12e2da5e87c701106342b846dabb354d" \
--request PATCH \
--header "Accept:application/json" \
--user ‘username’:’password’
반환 결과:
"result": {
"sys_id": "73c316d2474b0150003a4587746d4337"
}
WSD 예약 - PATCH /api/sn_wsd_rsv/reservation/share_details/{sys_id}
이메일 알림을 통해 예약 상세 정보를 업데이트하고 지정된 수신자 목록과 공유합니다. 선택적으로 예약과 함께 지정된 메시지를 보낼 수 있습니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/reservation/share_details/{sys_id}
기본 URL: /api/sn_wsd_rsv/reservation/share_details/{sys_id}
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 데이터 유형: 문자열 |
| sys_id | 공유할 예약의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 없음 |
| 이름 | 설명 |
|---|---|
| notification_custom_message | 지정된 수신자에게 보낼 메시지입니다. 데이터 유형: 문자열 |
| notification_recipients | 필수 이메일 알림을 보낼 사용자의 sys_ids 목록입니다. 사용자 [sys_user] 테이블에 있습니다. 데이터 형식: 배열 |
| notification_type | 보낼 알림의 유형입니다. 유효한 유형:
데이터 유형: 문자열 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.
| 헤더 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, application/xml 또는, text/xml. 기본값: application/json |
| 컨텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 헤더 | 설명 |
|---|---|
| 없음 |
상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| sys_id | 공유된 예약 기록의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 데이터 유형: 문자열 |
cURL 요청
다음 코드 예제에서는 이 엔드포인트를 사용하여 예약을 공유하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/share_details/60d26a0f47578910003a4587746d4331" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"notification_recipients\": [\"5dfb9fcf47d78910003a4587746d4367\"],
\"notification_type\":\"reservation_updated\",
\"notification_custom_message\": \"Please join our design brainstorming meeting!\"
}" \
--user "username":"password"
반환 결과:
"result": {
"sys_id": "60d26a0f47578910003a4587746d4331"
}
WSD 예약 - PATCH /api/sn_wsd_rsv/reservation/update/{sys_id}
지정된 직장 예약을 업데이트합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/reservation/update/{sys_id}
기본 URL: /api/sn_wsd_rsv/reservation/update/{sys_id}
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| sys_id | 수정할 예약의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| ignore_same_day_validation | 예약 검색에서 시작과 종료 매개변수 사이의 날짜 확인 변경을 무시하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 기본값: false |
| 이름 | 설명 |
|---|---|
| 끝 | 매개변수가 shift 전달되지 않은 경우 필요합니다. 요청된 예약 종료 시간입니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| is_private | 예약이 비공개인지 여부를 나타내는 플래그입니다. 비공개인 경우 예약은 소유자를 제외한 다른 사람에게 표시되지 않습니다. 이러한 개인 정보 설정에 대한 자세한 내용은 위치 개인 정보 보호 설정 및 영향을 참조하세요. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 기본값: 시스템 속성에서 개인정보 보호에 대해 설정된 값입니다. |
| 위치 | 필수 예약할 위치의 Sys_id입니다. 직장 위치[sn_wsd_core_workplace_location] 테이블에 있습니다. 데이터 유형: 문자열 |
| requested_for | 예약이 이루어지는 사용자의 Sys_id 또는 이메일 주소입니다. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| Shift | 예약과 연결할 교대조의 Sys_id입니다. 교대조 [sn_wsd_core_shift] 테이블에 있습니다. 이 매개 변수가 전달되면 end 매개 변수가 필요하지 않습니다. 교대조 기반 예약에 대한 자세한 내용은 교대조 기반 예약 사용을 참조하세요. 데이터 유형: 문자열 |
| 시작 | 필수 예약의 요청된 시작 시간입니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| 제목 | 필수 예약과 관련된 회의의 주제입니다. 데이터 유형: 문자열 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.
| 헤더 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, application/xml 또는, text/xml. 기본값: application/json |
| 컨텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 헤더 | 설명 |
|---|---|
| 없음 |
상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수(JSON 또는 XML)
| 이름 | 설명 |
|---|---|
| 결과 | 업데이트된 예약에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.location_id | 예약 위치 기록의 Sys_id입니다. 직장 위치[sn_wsd_core_workplace_location] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.sys_id | 수정된 예약 기록의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.type_of_change | 예약에서 업데이트된 정보의 유형입니다. 데이터 유형: 문자열 |
cURL 요청
다음 코드 예제에서는 이 엔드포인트를 사용하여 예약을 업데이트하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/update/b537abc947db4510003a4587746d4351" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"subject\": \"Rsv Update_1\",
\"start\": \"2022-07-21 14:00:00\",
\"end\": \"2022-07-21 15:00:00\",
\"requested_for\": \"workplace_user@example.com\",
\"workplace_location\": \"fe1f744edb7650106c731dcd139619ca\",
\"is_private\": \false\
}" \
--user "username":"password"
반환 결과:
{
"result": {
"sys_id": "b537abc947db4510003a4587746d4351",
"location_id": "fe1f744edb7650106c731dcd139619ca",
"type_of_change": "location"
}
}
WSD 예약 - POST /api/sn_wsd_rsv/reservation/add
새 직장 예약을 생성합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/reservation/add
기본 URL: /api/sn_wsd_rsv/reservation/add
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| ignore_same_day_validation | 예약 검색에서 시작과 종료 매개변수 사이의 날짜 확인 변경을 무시하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 기본값: false |
| 시간대 | 요청 확인을 수행하기 위한 기본 시간대입니다. 예: 유럽/암스테르담. 이 확인은 시작 시간과 종료 시간이 같은 날인지 여부를 확인합니다. 데이터 유형: 문자열 기본값: 사용자 시간대 |
| 이름 | 설명 |
|---|---|
| 끝 | 매개변수가 shift 전달되지 않은 경우 필요합니다. 요청된 예약 종료 시간입니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| is_private | 예약이 비공개인지 여부를 나타내는 플래그입니다. 비공개인 경우 예약은 소유자를 제외한 다른 사람에게 표시되지 않습니다. 이러한 개인 정보 설정에 대한 자세한 내용은 위치 개인 정보 보호 설정 및 영향을 참조하세요. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 기본값: 시스템 속성에서 개인정보 보호에 대해 설정된 값입니다. |
| 위치 | 필수 예약할 위치의 Sys_id입니다. 직장 위치[sn_wsd_core_workplace_location] 테이블에 있습니다. 데이터 유형: 문자열 |
| requested_for | 예약이 이루어지는 사용자의 Sys_id 또는 이메일 주소입니다. 사용자 [sys_user] 테이블에 있습니다. 데이터 유형: 문자열 |
| reservable_module | 필수 예약과 연결할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 예약에 필요한 직장 항목을 정의합니다. 예약 가능한 모듈 [sn_wsd_rsv_reservable_module] 테이블에 있습니다. 데이터 유형: 문자열 |
| Shift | 예약과 연결할 교대조의 Sys_id입니다. 교대조 [sn_wsd_core_shift] 테이블에 있습니다. 이 매개 변수가 전달되면 end 매개 변수가 필요하지 않습니다. 교대조 기반 예약에 대한 자세한 내용은 교대조 기반 예약 사용을 참조하세요. 데이터 유형: 문자열 |
| 시작 | 필수 예약의 요청된 시작 시간입니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| 제목 | 필수 예약과 관련된 회의의 주제입니다. 데이터 유형: 문자열 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.
| 헤더 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, application/xml 또는, text/xml. 기본값: application/json |
| 컨텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 헤더 | 설명 |
|---|---|
| 없음 |
상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| sys_id | 생성된 예약 기록의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 데이터 유형: 문자열 |
cURL 요청
다음 코드 예제에서는 이 엔드포인트를 사용하여 예약을 만드는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/add" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"reservable_module\": \"c31241cedb7650106c731dcd13961917\",
\"subject\": \"Test-123\",
\"reservation_purpose\": \"meeting\",
\"timezone\": \"US/Pacific\",
\"requested_for\": \"6816f79cc0a8016401c5a33be04be441\",
\"location\": \"5eafb44edb7650106c731dcd13961943\",
\"is_private\": false,
\"start\": \"2023-01-12T11:00:00Z\",
\"end\": \"2023-01-12T12:00:00Z\"
}" \
--user "username":"password"
반환 결과:
"result": {
"sys_id": "4b036a9e474b0150003a4587746d43b1"
}
WSD 예약 - POST /api/sn_wsd_rsv/reservation/quick_reserve
빠른 예약을 사용하여 새 직장 예약을 생성합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/reservation/quick_reserve
기본 URL: /api/sn_wsd_rsv/reservation/quick_reserve
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 없음 |
| 이름 | 설명 |
|---|---|
| 끝 | 매개변수가 shift 전달되지 않은 경우 필요합니다. 요청된 예약 종료 시간입니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| ignore_same_day_validation | 필수 엔드포인트가 와 end 매개변수 사이의 날짜 변경 유효성 검사를 무시하는지 여부를 나타내는 플래그입니다start. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| reference_location_id | 필수 사용자가 위치를 예약하려는 위치와 가까운 위치의 Sys_id입니다. 직장 위치[sn_wsd_core_workplace_location] 테이블에 있습니다. 데이터 유형: 문자열 |
| reservable_module | 필수 예약과 연결할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 예약에 필요한 직장 항목을 정의합니다. 예약 가능한 모듈 [sn_wsd_rsv_reservable_module] 테이블에 있습니다. 데이터 유형: 문자열 |
| Shift | 예약과 연결할 교대조의 Sys_id입니다. 교대조 [sn_wsd_core_shift] 테이블에 있습니다. 이 매개 변수가 전달되면 end 매개 변수가 필요하지 않습니다. 교대조 기반 예약에 대한 자세한 내용은 교대조 기반 예약 사용을 참조하세요. 데이터 유형: 문자열 |
| 시작 | 필수 예약의 요청된 시작 시간입니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.
| 헤더 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, application/xml 또는, text/xml. 기본값: application/json |
| 컨텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 헤더 | 설명 |
|---|---|
| 없음 |
상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| sys_id | 생성된 예약 기록의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다. 데이터 유형: 문자열 |
cURL 요청
다음 코드 예제에서는 빠른 예약 엔드포인트를 사용하여 예약을 만드는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/quick_reserve" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"start\":\"2022-05-23 16:00:00\",
\"end\": \"2022-05-23 17:00:00\",
\"reservable_module\": \"5db44502dbb650106c731dcd13961937\",
\"reference_location_id\": \"05f5290edb7210106c731dcd13961951\",
\"ignore_same_day_validation\": \"true\"
}" \
--user "username":"password"
반환 결과:
"result": {
"sys_id": "4b036a9e474b0150003a4587746d43b1"
}