WSD 예약 가능한 API

Xanadu API 참조

Release

xanadu

ft:locale

ko-KR

ft:publication_title

Xanadu API 참조

ft:clusterId

crapiref

bundleId

crapiref

workflow

Creator

WSD 예약 가능한 API

릴리스 버전: Xanadu

업데이트 날짜 2024년 08월 01일

읽기33분

(WSD) 예약 가능 API는 워크플레이스 서비스 제공 인스턴스에서 직장 위치와 같이 예약할 수 있는 엔터티인 예약 가능 항목의 상세 정보를 검색하는 엔드포인트를 ServiceNow 제공합니다.

주:

이 API의 최신 버전인 WSD 예약 가능 V2 API을(를) 사용할 수 있습니다. 새 버전에서는 매개 변수의 문자 제한을 피하기 위해 POST 요청에 모든 예약 가능 항목을 포함할 수 있습니다 sys_Id .

이 API에 액세스하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 합니다.

이 API는 sn_wsd_rsv 네임스페이스에서 실행됩니다. 이 API에 접근하려면 워크플레이스 예약 관리(sn_wsd_rsv) 플러그인을 활성화해야 합니다.

에 대한 워크플레이스 예약 관리자세한 내용은 워크플레이스 예약 관리를 참조하십시오.

WSD 예약 가능 - GET /sn_wsd_rsv/예약 가능/list_reservables/{sys_ids}

하나 이상의 지정된 예약 가능 항목에 대한 상세 정보를 반환합니다.

URL 형식

버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/reservable/list_reservables/{sys_ids}

기본 URL: /api/sn_wsd_rsv/reservable/list_reservables/{sys_ids}

지원되는 요청 매개변수

표 1. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열
sys_ids	반환할 상세 정보가 있는 예약 가능한 Sys_ids입니다. 여러 예약 가능한 항목을 지정하는 경우 sys_ids 쉼표로 구분합니다. 이러한 sys_ids는 직장 위치[sn_wsd_core_workplace_location] 테이블에 있습니다. 데이터 유형: 문자열

표 2. 쿼리 매개변수
이름	설명
include_flexible_services	예약 가능한 서비스와 연결된 유연한 서비스를 응답에 반환할지 여부를 나타내는 플래그입니다. 유연한 서비스는 예약 시 예약 가능한 직장 항목에 사용할 수 있는 추가 프로비저닝입니다. 예를 들어, 강의실 스타일 - 모든 참가자가 교실 앞쪽을 바라보는 방향으로 배열된 테이블 행입니다. 유연한 서비스에 대한 자세한 내용은 유연한 서비스 만들기를 참조하세요. 유효한 값은 다음과 같습니다. true: 유연한 서비스 정보를 반환합니다. false: 유연한 서비스 정보를 반환하지 않습니다. 데이터 유형: 부울 기본값: false
include_layouts	응답에서 위치 레이아웃 정보를 반환할지 여부를 나타내는 플래그입니다. 위치 레이아웃 정보에는 용량, 최대 용량, 준비 및 정리 기간 등이 포함됩니다. 이 정보는 위치 레이아웃 [sn_wsd_rsv_m2m_location_layout] 테이블에 있습니다. 유효한 값은 다음과 같습니다. true: 위치 레이아웃 정보를 반환합니다. false: 위치 레이아웃 정보를 반환하지 않습니다. 데이터 유형: 부울 기본값: false
include_standard_services	응답에서 표준 서비스 정보를 반환할지 여부를 나타내는 플래그입니다. 표준 서비스는 화이트 보드, 추가 모니터 및 이와 유사한 서비스와 같이 예약 시 예약 가능한 직장 항목에서 사용할 수 있는 기본 조항을 설명합니다. 표준 서비스에 대한 자세한 내용은 표준 서비스를 참조하세요. 이 정보는 표준 서비스 [sn_wsd_rsv_standard_service] 테이블에 있습니다. 유효한 값은 다음과 같습니다. true: 표준 서비스 정보를 반환합니다. false: 표준 서비스 정보를 반환하지 않습니다. 데이터 유형: 부울 기본값: false
reservable_module_sys_id	필수 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 유사한 유형의 직장 항목을 그룹화합니다. 이 sys_id은 예약 가능한 모듈 [sn_wsd_rsv_reservable_module] 테이블에 있습니다. 예약 가능한 모듈에 대한 자세한 내용은 예약 가능한 모듈 구성을 참조하십시오. 데이터 유형: 문자열
reservation_start_time	추가 서비스의 리드 타임을 확인하기 위한 예약 시작 시간입니다. 형식: UTC 형식, yyyy-MM-dd HH:mm:ss 데이터 유형: 문자열

표 3. 요청 본문 매개변수
이름	설명
없음

헤더

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

표 4. 요청 헤더
헤더	설명
수용	응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json

표 5. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

표 6. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
400	잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
401	승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
404	찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

응답 본문 매개변수


이름	설명
결과	일치하는 각 예약 가능 항목에 대한 상세 정보입니다. 데이터 형식: 객체 배열 { "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	사용자가 연결된 예약 가능 항목에 대한 개인정보 설정을 재정의할 수 있는지 여부를 나타내는 플래그입니다. 이러한 개인 정보 설정에 대한 자세한 내용은 위치 개인 정보 보호 설정 및 영향을 참조하세요. 유효한 값은 다음과 같습니다. true: 사용자가 연결된 예약 가능 항목에 대한 개인정보 설정을 재정의할 수 있습니다. false: 사용자가 연결된 예약 가능 항목에 대한 개인정보 설정을 재정의할 수 없습니다.
result.enable_group_reservations	사용자가 그룹을 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 그룹 예약을 할 수 있습니다. false: 그룹 예약을 할 수 없습니다. 데이터 유형: 부울
result.enable_reservation_privacy	예약 개인정보 보호에 대한 기본 설정을 나타내는 플래그입니다. 이러한 개인 정보 설정에 대한 자세한 내용은 을 참조하십시오 Location privacy settings and impact. 가능한 값: 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: 여러 항목을 선택할 수 있습니다. 데이터 유형: 부울
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: 용량이 표시되지 않아야 합니다. 데이터 유형: 부울
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: 수량이 표시되지 않아야 합니다. 데이터 유형: 부울
result.flexible_services.flexible_service입니다.flexible_service.quantity_required	수량이 필요한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 수량이 필요합니다. false: 수량이 필요하지 않습니다. 데이터 유형: 부울
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: 유연한 서비스를 예약할 수 없습니다. 데이터 유형: 부울
결과.레이아웃	매개 변수가 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
    }
  ]
}