---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference
Release :
- xanadu
ft:locale :
- ko-KR
ft:publication_title :
- Xanadu API 참조
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# WSD 예약 가능한 API
# WSD 예약 가능한 API {#ariaid-title1}
* 릴리스 버전: Xanadu
*
* 업데이트 날짜 2024년 08월 01일
*
*  소요 시간: 33분
(WSD) 예약 가능 API는 워크플레이스 서비스 제공 인스턴스에서 직장 위치와 같이 예약할 수 있는 엔터티인 예약 가능 항목의 상세 정보를 검색하는 엔드포인트를 ServiceNow 제공합니다.
주:
이 API의 최신 버전인 [WSD 예약 가능 V2 API](https://servicenow-prod.fluidtopics.net/5j7nSAo4O47t3iYeFLvXMA#wsd_reservable-api-V2 "(WSD) 예약 가능 V2 API는 워크플레이스 서비스 제공 인스턴스에서 직장 위치와 같이 예약할 수 있는 엔터티인 예약 가능 항목의 상세 정보를 검색하는 엔드포인트를 ServiceNow 제공합니다.")을(를) 사용할 수 있습니다. 새 버전에서는 매개 변수의 문자 제한을 피하기 위해 POST 요청에 모든 예약 가능 항목을 포함할 수 있습니다 sys_Id .
이 API에 액세스하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 합니다.
이 API는 `sn_wsd_rsv` 네임스페이스에서 실행됩니다. 이 API에 접근하려면 워크플레이스 예약 관리(sn_wsd_rsv) 플러그인을 활성화해야 합니다.
에 대한 워크플레이스 예약 관리자세한 내용은 [워크플레이스 예약 관리를](https://www.servicenow.com/docs/access?context=workplace-rsv-mgmt-feat&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US) 참조하십시오.
## WSD 예약 가능 - GET /sn_wsd_rsv/예약 가능/list_reservables/{sys_ids} {#ariaid-title2}
하나 이상의 지정된 예약 가능 항목에 대한 상세 정보를 반환합니다.
### URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/reservable/list_reservables/{sys_ids}
기본 URL: /api/sn_wsd_rsv/reservable/list_reservables/{sys_ids}
### 지원되는 요청 매개변수
{#wsd_reservable-GET-list_reserv__entry__2}{#wsd_reservable-GET-list_reserv__version-RESTAPI}
| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| sys_ids | 반환할 상세 정보가 있는 예약 가능한 Sys_ids입니다. 여러 예약 가능한 항목을 지정하는 경우 sys_ids 쉼표로 구분합니다. 이러한 sys_ids는 직장 위치\[sn_wsd_core_workplace_location\] 테이블에 있습니다. 데이터 유형: 문자열 |
[표 1. 경로 매개변수]
{#wsd_reservable-GET-list_reserv__entry__8}{#wsd_reservable-GET-list_reserv__include_standard_services-reserv-entry}{#wsd_reservable-GET-list_reserv__reservation_ids-reserv-start-entry}
| 이름 | 설명 |
|-|-|
| include_flexible_services | 예약 가능한 서비스와 연결된 유연한 서비스를 응답에 반환할지 여부를 나타내는 플래그입니다. 유연한 서비스는 예약 시 예약 가능한 직장 항목에 사용할 수 있는 추가 프로비저닝입니다. 예를 들어, 강의실 스타일 - 모든 참가자가 교실 앞쪽을 바라보는 방향으로 배열된 테이블 행입니다. 유연한 서비스에 대한 자세한 내용은 [유연한 서비스 만들기를](https://www.servicenow.com/docs/access?context=add-flexible-service&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US) 참조하세요. 유효한 값은 다음과 같습니다. * true: 유연한 서비스 정보를 반환합니다. * false: 유연한 서비스 정보를 반환하지 않습니다. 데이터 유형: 부울 기본값: false |
| include_layouts | 응답에서 위치 레이아웃 정보를 반환할지 여부를 나타내는 플래그입니다. 위치 레이아웃 정보에는 용량, 최대 용량, 준비 및 정리 기간 등이 포함됩니다. 이 정보는 위치 레이아웃 \[sn_wsd_rsv_m2m_location_layout\] 테이블에 있습니다. 유효한 값은 다음과 같습니다. * true: 위치 레이아웃 정보를 반환합니다. * false: 위치 레이아웃 정보를 반환하지 않습니다. 데이터 유형: 부울 기본값: false |
| include_standard_services | 응답에서 표준 서비스 정보를 반환할지 여부를 나타내는 플래그입니다. 표준 서비스는 화이트 보드, 추가 모니터 및 이와 유사한 서비스와 같이 예약 시 예약 가능한 직장 항목에서 사용할 수 있는 기본 조항을 설명합니다. 표준 서비스에 대한 자세한 내용은 [표준 서비스를](https://www.servicenow.com/docs/access?context=standard-service&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US) 참조하세요. 이 정보는 표준 서비스 \[sn_wsd_rsv_standard_service\] 테이블에 있습니다. 유효한 값은 다음과 같습니다. * true: 표준 서비스 정보를 반환합니다. * false: 표준 서비스 정보를 반환하지 않습니다. 데이터 유형: 부울 기본값: false |
| reservable_module_sys_id | 필수 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 유사한 유형의 직장 항목을 그룹화합니다. 이 sys_id은 예약 가능한 모듈 \[sn_wsd_rsv_reservable_module\] 테이블에 있습니다. 예약 가능한 모듈에 대한 자세한 내용은 [예약 가능한 모듈 구성을](https://www.servicenow.com/docs/access?context=config-reservable-module&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US) 참조하십시오. 데이터 유형: 문자열 |
| reservation_start_time | 추가 서비스의 리드 타임을 확인하기 위한 예약 시작 시간입니다. 형식: UTC 형식, yyyy-MM-dd HH:mm:ss 데이터 유형: 문자열 |
[표 2. 쿼리 매개변수]
{#wsd_reservable-GET-list_reserv__entry__20}
| 이름 | 설명 |
|-|-|
| 없음 | |
[표 3. 요청 본문 매개변수]
### 헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#wsd_reservable-GET-list_reserv__entry__24}{#wsd_reservable-GET-list_reserv__accept-RESTAPI}
| 헤더 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 4. 요청 헤더]
{#wsd_reservable-GET-list_reserv__entry__28}
| 헤더 | 설명 |
|-|-|
| 없음 | |
[표 5. 응답 헤더]
### 상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#wsd_reservable-GET-list_reserv__entry__32}{#wsd_reservable-GET-list_reserv__entry-200-status-code}{#wsd_reservable-GET-list_reserv__entry-400-status-code}{#wsd_reservable-GET-list_reserv__entry-401-status-code}{#wsd_reservable-GET-list_reserv__entry-404-status-code}{#wsd_reservable-GET-list_reserv__entry-500-status-code}
| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]
### 응답 본문 매개변수
{#wsd_reservable-GET-list_reserv__entry__44}{#wsd_reservable-GET-list_reserv__allow_invitees-reserv_mod-entry}{#wsd_reservable-GET-list_reserv__building-reserv-entry}{#wsd_reservable-GET-list_reserv__building_display_value-reserv-entry}{#wsd_reservable-GET-list_reserv__building_sys_id-reserv-entry}{#wsd_reservable-GET-list_reserv__building_timezone-reserv-entry}{#wsd_reservable-GET-list_reserv__building_timezone_display_value-reserv-entry}{#wsd_reservable-GET-list_reserv__building_timezone_value-reserv-entry}{#wsd_reservable-GET-list_reserv__display_number_of_attendees-reserv_mod-entry}{#wsd_reservable-GET-list_reserv__display_on_behalf_of-reserv_mod-entry}{#wsd_reservable-GET-list_reserv__display_sensitivity-reserv_mod-entry}{#wsd_reservable-GET-list_reserv__enable_group_reservations-reserv_mod-entry}{#wsd_reservable-GET-list_reserv__floor_display_value-reserv-entry}{#wsd_reservable-GET-list_reserv__layouts-reserv-entry}{#wsd_reservable-GET-list_reserv__layouts_capacity-reserv-entry}{#wsd_reservable-GET-list_reserv__layouts_cleanup_duration-reserv-entry}{#wsd_reservable-GET-list_reserv__layouts_image-reserv-entry}{#wsd_reservable-GET-list_reserv__layouts_image_link-reserv-entry}{#wsd_reservable-GET-list_reserv__layouts_image_sys_id-reserv-entry}{#wsd_reservable-GET-list_reserv__layouts_is_default-reserv-entry}{#wsd_reservable-GET-list_reserv__layouts_max_capacity-reserv-entry}{#wsd_reservable-GET-list_reserv__layouts_name-reserv-entry}{#wsd_reservable-GET-list_reserv__layouts_preparation_duration-reserv-entry}{#wsd_reservable-GET-list_reserv__layouts_short_description-reserv-entry}{#wsd_reservable-GET-list_reserv__layouts_sys_id-reserv-entry}{#wsd_reservable-GET-list_reserv__location_type-reserv-entry}{#wsd_reservable-GET-list_reserv__location_type_display_value-reserv-entry}{#wsd_reservable-GET-list_reserv__location_type_sys_id-reserv-entry}{#wsd_reservable-GET-list_reserv__name-reserv-entry}{#wsd_reservable-GET-list_reserv__number-reserv-entry}{#wsd_reservable-GET-list_reserv__order-reserv-entry}{#wsd_reservable-GET-list_reserv__require_approval-reserv-entry}{#wsd_reservable-GET-list_reserv__requires_check_in-reserv-entry}{#wsd_reservable-GET-list_reserv__require_subject-reserv_mod-entry}{#wsd_reservable-GET-list_reserv__reservable_quantity-reserv-entry}{#wsd_reservable-GET-list_reserv__site-reserv-entry}{#wsd_reservable-GET-list_reserv__site_display_value-reserv-entry}{#wsd_reservable-GET-list_reserv__std_serv-reserv-entry}{#wsd_reservable-GET-list_reserv__std_serv_font-awesome_icon-reserv-entry}{#wsd_reservable-GET-list_reserv__std_serv_name-reserv-entry}{#wsd_reservable-GET-list_reserv__std_serv_short_description-reserv-entry}{#wsd_reservable-GET-list_reserv__std_serv_sys_id-reserv-entry}{#wsd_reservable-GET-list_reserv__site_sys_id-reserv-entry}{#wsd_reservable-GET-list_reserv__tableName-reserv-entry}{#wsd_reservable-GET-list_reserv__title-reserv-entry}{#wsd_reservable-GET-list_reserv__type-reserv-entry}
| 이름 | 설명 |
|-|-|
| 결과 | 일치하는 각 예약 가능 항목에 대한 상세 정보입니다. 데이터 형식: 객체 배열 { "result": [ { "allow_invitees": Boolean, "area": {Object}, "building": {Object}, "campus": {Object}, "capacity": Number, "description": "String", "display_number_of_attendees": Boolean, "display_on_behalf_of": Boolean, "display_sensitivity": Boolean, "email": "String", "employee_override_privacy": Boolean "enable_group_reservations": Boolean, "enable_reservation_privacy": Boolean, "external_id": "String", "flexible_services": [Array], "floor": {Object}, "image": {Object}, "is_reservable": Boolean, "layouts": [Array], "location_type": {Object}, "meetingProviders": [Array], "moduleType": "String", "name": "String", "number": "String", "order": Number, "require_approval": Boolean, "requires_check_in": Boolean, "require_subject": Boolean, "reservable_quantity": Number, "site": {Object}, "standard_services": [Array], "sys_id": "String", "title": "String", "type": "String", "tableName": "String" } ] } |
| result.allow_invitees | 직원이 예약에 초대를 추가할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 직원이 예약에 초대 대상자를 추가할 수 있도록 허용합니다. * false: 직원이 예약에 초대받은 사람을 추가할 수 없습니다. 데이터 유형: 부울 |
| 결과.면적 | 예약 가능한 항목이 있는 지역입니다. 이 정보는 영역 \[sn_wsd_core_area\] 테이블에 있습니다. "area": { "display_value": "String", "sys_id": "String" } |
| result.area.display_value | 면적의 값을 표시합니다. 데이터 유형: 문자열 |
| result.area.sys_id | 연결된 영역 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| 결과.건물 | 예약 가능한 건물이 있는 건물입니다. 이 정보는 건물 \[sn_wsd_core_building\] 테이블에 있습니다. "building": { "display_value": "String", "sys_id": "String", "timezone": {Object} } |
| result.building.display_value | 건물의 값을 표시합니다. 데이터 유형: 문자열 |
| result.building.sys_id | 연결된 건물 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| 결과.건물.시간대 | 건물의 시간대에 대한 상세 정보입니다. "timezone": { "displayValue": "String", "value": "String" } |
| result.building.timezone.display_value | 연결된 건물이 있는 시간대의 값을 표시합니다. 데이터 유형: 문자열 |
| 결과.건물.시간대.값 | 연결된 건물이 위치한 시간대의 내부 값입니다. 데이터 유형: 문자열 |
| 결과.캠퍼스 | 예약 가능 항목이 있는 캠퍼스입니다. 이 정보는 캠퍼스 \[sn_wsd_core_campus\] 테이블에 있습니다. "campus": { "display_value": "String", "sys_id": "String" } |
| result.campus.display_value | 캠퍼스의 값을 표시합니다. 데이터 유형: 문자열 |
| result.campus.sys_id | 연결된 캠퍼스 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.capacity | 예약 가능한 인원을 수용할 수 있는 인원 수입니다. 데이터 유형: 숫자 |
| 결과.설명 | 예약 가능한 항목에 대한 설명입니다. 데이터 유형: 문자열 |
| result.display_number_of_attendees | 사용자가 예약의 참석자 수를 지정할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 사용자가 참석자 수를 지정할 수 있습니다. * false: 사용자가 참석자 표시 수를 지정할 수 없습니다. 데이터 유형: 부울 |
| result.display_on_behalf_of | 다른 사람을 대신하여 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 지원하는 사람을 대신합니다. * false: 대신 지원되지 않습니다. 데이터 유형: 부울 |
| result.display_sensitivity | 사용자가 예약의 민감도(예: 일반 또는 비공개)를 설정할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 감도를 설정할 수 있습니다. * false: 민감도를 설정할 수 없습니다. 기본값은 normal입니다. 데이터 유형: 부울 |
| result.email | 예약 가능한 것과 연결된 이메일 주소입니다. 데이터 유형: 문자열 |
| result.employee_override_privacy | 사용자가 연결된 예약 가능 항목에 대한 개인정보 설정을 재정의할 수 있는지 여부를 나타내는 플래그입니다. 이러한 개인 정보 설정에 대한 자세한 내용은 [위치 개인 정보 보호 설정 및 영향을](https://www.servicenow.com/docs/access?context=location-privacy-settings-and-impact&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US) 참조하세요. 유효한 값은 다음과 같습니다. * true: 사용자가 연결된 예약 가능 항목에 대한 개인정보 설정을 재정의할 수 있습니다. * false: 사용자가 연결된 예약 가능 항목에 대한 개인정보 설정을 재정의할 수 없습니다. |
| result.enable_group_reservations | 사용자가 그룹을 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 그룹 예약을 할 수 있습니다. * false: 그룹 예약을 할 수 없습니다. 데이터 유형: 부울 |
| result.enable_reservation_privacy | 예약 개인정보 보호에 대한 기본 설정을 나타내는 플래그입니다. 이러한 개인 정보 설정에 대한 자세한 내용은 을 참조하십시오 [Location privacy settings and impact](https://www.servicenow.com/docs/access?context=location-privacy-settings-and-impact&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US). 가능한 값: * true: 예약은 기본적으로 비공개입니다. * false: 예약은 기본적으로 비공개가 아닙니다. 데이터 유형: 부울 |
| result.external_id | 예약 가능한 항목의 외부 ID입니다. 데이터 유형: 문자열 |
| result.flexible_services | 매개변수가 include_flexible_services true로 설정되고 워크플레이스 케이스 관리 플러그인이 설치된 경우에만 채워집니다. 예약 가능 항목과 연결된 유연한 서비스에 대한 설명입니다. 상위 유연 서비스와 여러 하위 유연 서비스가 있을 수 있습니다. 이 정보는 \[sn_wsd_case_workplace_service_item\] 테이블에 있습니다. flexible_services": [ { "additional_text": "String", "allow_only_single_service_item_selection": Boolean, "category": "String", "currency_code": "String", "flexible_service": [Array], "label": "String", "sub_category": "String", "sub_title": "String", "text": "String", "title": {Object} } ] |
| result.flexible_services.additional_text입니다. | 사용자에게 유연한 추가 서비스를 선택하라는 메시지를 표시하는 텍스트입니다. 데이터 유형: 문자열 |
| result.flexible_services.allow_only_single_service_item_selection | 사용자가 예약 내 유연한 서비스 그룹 중에서 하나의 서비스 항목만 선택할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 단일 항목만 선택할 수 있습니다. * false: 여러 항목을 선택할 수 있습니다. {#wsd_reservable-GET-list_reserv__ul_hbg_ngt_qtb} 데이터 유형: 부울 |
| result.flexible_services.category | 유연한 서비스의 범주입니다. 데이터 유형: 문자열 |
| result.flexible_services.currency_code | 유연한 서비스를 주문할 때 통화 금액을 계산하는 데 사용되는 통화 코드입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service | 상위 유연한 서비스에 해당하는 유연한 서비스입니다. 이 정보는 \[sn_wsd_case_workplace_service_item\] 테이블에 있습니다. 데이터 형식: 객체 배열 "flexible_service": [ { "flexible_service": [Array], "label": "String", "sub_category": "String" } ] |
| result.flexible_services.flexible_service입니다.flexible_service | 상위 유연 서비스에 해당하는 각 유연 서비스의 상세 정보입니다. 데이터 형식: 객체 배열 "flexible_service": [ { "additional_text": "String", "capacity_enabled": Boolean, "category": "String", "category_label": "String", "cleanup_duration": "String", "image": "String", "max_capacity": Number, "name": "String", "preparation_duration": "String", "price_per_unit": {Object}, "quantity_enabled": Boolean, "quantity_required": Boolean, "short_description": "String", "sub_category": "String", "sub_category_label": "String", "sub_title": "String", "sys_id": "String", "text": "String", "title": {Object} } ] |
| result.flexible_services.flexible_service입니다.flexible_service.additional_text입니다. | 사용자에게 유연한 추가 서비스를 선택하라는 메시지를 표시하는 데 사용되는 텍스트입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.capacity_enabled | 회의실의 용량을 예약에 표시해야 하는지 여부를 나타내는 플래그입니다. 이 값을 예로 quantity_enabled 설정하면 항상 아니오가 됩니다. 유효한 값은 다음과 같습니다. * true: 용량이 표시됩니다. * false: 용량이 표시되지 않아야 합니다. {#wsd_reservable-GET-list_reserv__ul_f3q_pmt_qtb} 데이터 유형: 부울 |
| result.flexible_services.flexible_service입니다.flexible_service.category | 유연 서비스의 범주입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.category_label | 유연한 서비스의 범주 레이블입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.cleanup_duration | 예약 가능 항목에 추가된 서비스를 정리하거나 제거하는 데 걸리는 시간입니다. 데이터 유형: 숫자 단위: 밀리초 |
| result.flexible_services.flexible_service입니다.flexible_service.이미지 | 유연한 서비스의 이미지에 대한 링크입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.max_capacity | 예약 가능한 최대 수용자 수입니다. 데이터 유형: 숫자 |
| result.flexible_services.flexible_service입니다.flexible_service.이름 | 유연한 서비스의 이름입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.preparation_duration | 예약 가능한 서비스에 서비스를 추가하는 데 걸리는 시간입니다. 데이터 유형: 문자열 단위: 밀리초 |
| result.flexible_services.flexible_service입니다.flexible_service.price_per_unit입니다. | 예약 가능한 항목에 유연한 서비스를 추가하는 비용에 대한 상세 정보입니다. 데이터 유형: 객체 "price_per_unit": { "code": "String", "value": "String" } |
| result.flexible_services.flexible_service입니다.flexible_service.price_per_unit.code | 비용을 계산할 때 사용할 통화 코드입니다(예: GBP 또는 USD). 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.price_per_unit.value | 유연 서비스의 각 단위에 대한 비용(코드 매개변수에 정의된 통화)입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.quantity_enabled | 수량 필드를 예약에 표시할지 여부를 나타내는 플래그입니다. 이 값을 예로 capacity_enabled 설정하면 항상 아니오가 됩니다. 유효한 값은 다음과 같습니다. * true: 수량이 표시됩니다. * false: 수량이 표시되지 않아야 합니다. {#wsd_reservable-GET-list_reserv__ul_lvx_jj4_ytb} 데이터 유형: 부울 |
| result.flexible_services.flexible_service입니다.flexible_service.quantity_required | 수량이 필요한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 수량이 필요합니다. * false: 수량이 필요하지 않습니다. {#wsd_reservable-GET-list_reserv__ul_cfr_rqc_25b} 데이터 유형: 부울 |
| result.flexible_services.flexible_service입니다.flexible_service.short_description | 유연한 서비스에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.하위_범주 | 유연한 서비스의 하위 범주 이름입니다(예: chair_layout). 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.하위_범주_레이블 | 의자 레이아웃과 같은 유연한 서비스의 하위 범주 레이블입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.하위_제목 | 하위 유연한 서비스의 부제목 이름입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.sys_id | 유연한 서비스 Sys_id. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.텍스트 | 사용자에게 유연한 서비스를 선택하라는 메시지를 표시하는 데 사용되는 텍스트입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.제목 | UI에서 하위 유연한 서비스를 추가하고 편집할 때 사용할 제목의 세부 정보입니다. 데이터 유형: 객체 "title": { "add": "String", "edit": "String" } |
| result.flexible_services.flexible_service입니다.flexible_service.title.add | UI에서 하위 유연한 서비스를 추가할 때 사용되는 제목입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.flexible_service.title.편집 | UI에서 하위 유연한 서비스를 편집할 때 사용되는 제목입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service.label | 유연한 서비스 라벨. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.sub_category | 상위 유연 서비스의 하위 범주입니다(예: 추가 의자). 데이터 유형: 문자열 |
| result.flexible_services.flexible_service입니다.sub_title | 상위 유연한 서비스의 부제목 이름입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service.text | 사용자에게 상위 유연 서비스를 선택하라는 메시지를 표시하는 데 사용되는 텍스트입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service.title | UI에서 상위 유연한 서비스를 추가하고 편집할 때 사용할 제목의 상세 정보입니다. 데이터 유형: 객체 "title": { "add": "String", "edit": "String" } |
| result.flexible_services.flexible_service.title입니다.더하다 | UI에서 상위 유연한 서비스를 추가할 때 사용되는 제목입니다. 데이터 유형: 문자열 |
| result.flexible_services.flexible_service.title입니다.편집하다 | UI에서 상위 유연한 서비스를 편집할 때 사용되는 제목입니다. 데이터 유형: 문자열 |
| 결과.층 | 예약 가능한 층에 대한 상세 정보입니다. 층 \[sn_wsd_core_floor\] 테이블에 있습니다. "floor": { "display_value": "String", "sys_id": "String" } |
| result.floor.display_value | 예약 가능한 항목이 있는 층의 번호를 표시합니다(예: 12). 데이터 유형: 문자열 |
| result.floor.sys_id | 플로어 테이블에 있는 연결된 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| 결과.이미지 | 연결된 예약 가능 항목을 나타내는 이미지에 대한 상세 정보입니다. 이미지 \[db_image\] 테이블에 있습니다. "image": { "link": "String", "sys_id": "String" } |
| result.image.link | 예약 가능 항목을 나타내는 이미지에 연결합니다. 데이터 유형: 문자열 |
| result.image.sys_id | 연결된 이미지 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.is_reservable | 유연한 서비스를 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 유연한 서비스를 예약할 수 있습니다. * false: 유연한 서비스를 예약할 수 없습니다. {#wsd_reservable-GET-list_reserv__ul_e13_mc5_qtb} 데이터 유형: 부울 |
| 결과.레이아웃 | 매개 변수가 true로 설정된 경우에만 include_layouts 채워집니다. 예약 가능한 항목과 연결된 레이아웃의 목록입니다. 데이터 형식: 객체 배열 "layouts": [ { "capacity": Number, "cleanup_duration": "String", "image": {Object}, "is_default": Boolean, "max_capacity": Number, "name": "String", "preparation_duration": "String", "short_description": "String", "sys_id": "String" } ] |
| result.layouts.capacity | 회의에 참석할 사람 수입니다. 데이터 유형: 숫자 |
| result.layouts.cleanup_duration | 이 레이아웃의 예약 가능한 항목을 정리하는 데 걸리는 시간입니다. 데이터 유형: 숫자 단위: 밀리초 |
| result.layouts.image | 연결된 예약 가능 항목의 레이아웃을 나타내는 이미지에 대한 상세 정보입니다. 이미지 \[db_image\] 테이블에 있습니다. "image": { "link": "String", "sys_id": "String" } |
| result.layouts.image.link | 이 예약 가능한 항목의 레이아웃을 나타내는 이미지에 링크합니다. 이미지 \[db_image\] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.layouts.image.sys_id | 연결된 이미지 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.layouts.is_default | 연결된 레이아웃이 예약 가능한 항목의 기본값인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 기본값입니다. * false: 기본값이 아닙니다. 데이터 유형: 부울 |
| result.layouts.max_capacity | 예약 가능 항목과 연결된 레이아웃이 수용할 수 있는 최대 인원수입니다. 데이터 유형: 숫자 |
| result.layouts.name | 위치 레이아웃의 이름입니다. 데이터 유형: 문자열 |
| result.layouts.preparation_duration | 연결된 위치 레이아웃을 준비하는 데 걸리는 시간입니다. 데이터 유형: 숫자 단위: 밀리초 |
| result.layouts.short_description | 위치 레이아웃에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.layouts.sys_id | 위치 레이아웃의 Sys_id입니다. 레이아웃 \[sn_wsd_rsv_layout\] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.location_type | 업무 공간/책상, 카페 또는 체육관과 같은 예약 가능한 위치의 유형에 대한 상세 정보입니다. 공간 유형 \[sn_wsd_core_space_type\] 테이블에 있습니다. "location_type": { "display_value": "String", "sys_id": "String" } |
| result.location_type.display_value | 위치 유형의 표시 값입니다. 데이터 유형: 문자열 |
| result.location_type.sys_id | 공간 유형 \[sn_wsd_core_space_type\] 테이블에 있는 연결된 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.meetingProviders | 예약 가능한 항목과 연결된 가상 회의 제공자에 대한 상세 정보입니다. 이 정보는 가상 회의 공급자 \[sn_wsd_rsv_virtual_meeting_provider\] 테이블에 있습니다. "meetingProviders": [ { "display_value": "String", "value": "String" } ] |
| result.meetingProviders.display_value | 가상 제공자 이름의 값을 표시합니다. 데이터 유형: 문자열 |
| result.meetingProviders.value | 기록에 있는 가상 제공자 이름의 실제 값입니다. 데이터 유형: 문자열 |
| result.moduleType | 책상이나 회의실과 같이 예약 가능한 항목과 연결된 예약 가능한 모듈입니다. 데이터 유형: 문자열 |
| result.name | 예약 가능한 항목의 이름입니다. 데이터 유형: 문자열 |
| 결과.번호 | 예약 가능한 항목의 고유 식별자입니다. 이 값은 sys_id보다 사람이 더 쉽게 읽을 수 있습니다. 데이터 유형: 문자열 |
| 결과.순서 | 예약 가능한 순서 번호입니다. 데이터 유형: 숫자 |
| result.require_approval | 예약 가능한 예약에 승인이 필요한지 여부를 나타내는 플래그입니다. 가능한 값: * true: 승인이 필요합니다. * false: 승인이 필요하지 않습니다. 데이터 유형: 부울 |
| result.requires_check_in | 예약 가능 여부에 따라 사용자의 체크인이 필요한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 체크인 필요 * false: 체크 인이 필요하지 않습니다. 데이터 유형: 부울 |
| result.require_subject | 예약 시 사용자가 제목을 입력해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 제목이 필요합니다. * false: 제목이 필요하지 않습니다. 데이터 유형: 부울 |
| result.reservable_quantity | 연결된 예약 가능한 최대 시간을 동시에 예약할 수 있는 최대 횟수입니다. 이 값은 인접 공간을 영역에 할당할 때 사용됩니다. 데이터 형식: 정수 |
| result.site | 예약 가능한 항목이 있는 사이트에 대한 상세 정보입니다. 사이트 \[sn_wsd_core_site\] 테이블에 있습니다. "site": { "display_value": "String", "sys_id": "String" } |
| result.site.display_value | 사이트의 표시 값입니다. 데이터 유형: 문자열 |
| result.standard_services | 매개 변수가 true로 설정된 경우에만 include_standard_services 채워집니다. 플립 차트, 프로젝터 화면, 화이트보드 및 마커와 같은 관련된 표준 서비스입니다. 데이터 형식: 객체 배열 "standard_services": [ { "font_awesome_icon": "String", "name": "String", "short_description": "String", "sys_id": "String" } ] |
| 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\] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.site.sys_id | 사이트 \[sn_wsd_core_site\] 테이블에 있는 연결된 사이트 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.tableName | 예약 가능한 기록이 있는 테이블의 이름입니다. 데이터 유형: 문자열 |
| result.title | 예약 가능한 항목의 제목입니다. 데이터 유형: 문자열 |
| 결과.유형 | 위치와 같은 예약 가능한 유형입니다. 데이터 유형: 문자열 |
[ ]
### cURL 요청
다음 코드 예제에서는 이 끝점을 호출하는 방법을 보여 줍니다.
curl "http://instance.servicenow.com/api/sn_wsd_rsv/reservable/list_reservables/dad3df5977220110b3d7be377b5a99ce,3ed3139977220110b3d7be377b5a99d1?include_flexible_services=true&include_layouts=false&include_reservable_purposes=true&include_standard_services=true&reservable_module_sys_id=c31241cedb7650106c731dcd13961917" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
반환 결과:
{
"result": [
{
"sys_id": "3e41e94adb7210106c731dcd1396198c",
"external_id": null,
"wsd_email": null,
"name": "A1-02-04",
"title": "A1-02-04",
"description": "General desk available for reservation.",
"image": null,
"number": "SPCE0009004",
"site": {
"sys_id": "628eec06db7650106c731dcd139619dd",
"display_value": "North America"
},
"campus": {
"sys_id": "82b2a0cedb3650106c731dcd139619e9",
"display_value": "California Campus"
},
"building": {
"sys_id": "94e264cedb3650106c731dcd13961919",
"display_value": "CAL-B1",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"floor": {
"sys_id": "fc7368cedb3650106c731dcd13961902",
"display_value": "Floor 1"
},
"area": null,
"capacity": "1",
"reservable_quantity": null,
"location_type": {
"sys_id": "5f017383eb512010b89bfdfc9c5228c8",
"display_value": "Workspace/Desk"
},
"order": null,
"requires_check_in": null,
"is_reservable": "1",
"type": "location",
"moduleType": "Desks",
"meetingProviders": [],
"require_subject": false,
"allow_invitees": true,
"display_number_of_attendees": false,
"display_on_behalf_of": true,
"display_sensitivity": false,
"enable_group_reservations": false,
"enable_reservation_privacy": true,
"employee_override_privacy": true,
"tableName": "sn_wsd_core_space",
"require_approval": false
},
{
"sys_id": "fd41a94adb7210106c731dcd1396195a",
"external_id": null,
"wsd_email": null,
"name": "A1-02-03",
"title": "A1-02-03",
"description": "General desk available for reservation.",
"image": null,
"number": "SPCE0009003",
"site": {
"sys_id": "628eec06db7650106c731dcd139619dd",
"display_value": "North America"
},
"campus": {
"sys_id": "82b2a0cedb3650106c731dcd139619e9",
"display_value": "California Campus"
},
"building": {
"sys_id": "94e264cedb3650106c731dcd13961919",
"display_value": "CAL-B1",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"floor": {
"sys_id": "fc7368cedb3650106c731dcd13961902",
"display_value": "Floor 1"
},
"area": null,
"capacity": "1",
"reservable_quantity": null,
"location_type": {
"sys_id": "5f017383eb512010b89bfdfc9c5228c8",
"display_value": "Workspace/Desk"
},
"order": null,
"requires_check_in": null,
"is_reservable": "1",
"type": "location",
"moduleType": "Desks",
"meetingProviders": [],
"require_subject": false,
"allow_invitees": true,
"display_number_of_attendees": false,
"display_on_behalf_of": true,
"display_sensitivity": false,
"enable_group_reservations": false,
"enable_reservation_privacy": true,
"employee_override_privacy": true,
"tableName": "sn_wsd_core_space",
"require_approval": false
}
]
}