WSD 예약 가능 V2 API

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기39분

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

    WSD 예약 가능한 V2 API는 WSD 예약 가능한 API. WSD 예약 가능한 V2 API는 예약하는 동안 선택한 WSD 포털의 모든 예약 가능한 공간에 대한 상세 정보를 가져옵니다. 원래 WSD 예약 가능 API 버전은 GET 호출을 사용했지만 sys_ID 경로 매개 변수를 35자로 제한했습니다. 새 WSD 예약 가능 V2 API 버전은 POST 호출이며 문자 제한을 피하기 위해 요청 본문의 모든 sys_ids 사용합니다.

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

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

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

    WSD 예약 가능 V2 API - POST /sn_wsd_rsv/v2/예약 가능/list_reservables

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

    URL 형식

    기본 URL: POST api/sn_wsd_rsv/v2/reservable/list_reservables

    지원되는 요청 매개변수

    표 1. 경로 매개변수
    이름 설명
    api_version 필수 액세스할 엔드포인트의 버전입니다. 이 API를 사용하려면 v2 를 지정하고, 그렇지 않으면 v1 을 사용하면 WSD 예약 가능 API의 기본 버전이 사용됩니다.

    데이터 유형: 문자열
    표 2. 쿼리 매개변수
    이름 설명
    없음
    표 3. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    include_flexible_services 예약 가능한 서비스와 연결된 유연한 서비스를 응답에 반환할지 여부를 나타내는 플래그입니다.

    유연한 서비스는 예약 시 예약 가능한 직장 항목에 사용할 수 있는 추가 프로비저닝입니다. 예를 들어, 강의실 스타일 - 모든 참가자가 교실 앞쪽을 바라보는 방향으로 배열된 테이블 행입니다. 유연한 서비스에 대한 자세한 내용은 유연한 서비스 만들기를 참조하세요.

    유효한 값은 다음과 같습니다.
    • true: 유연한 서비스 정보를 반환합니다.
    • false: 유연한 서비스 정보를 반환하지 않습니다.

    데이터 유형: 부울

    기본값: false
    include_standard_services 응답에서 표준 서비스 정보를 반환할지 여부를 나타내는 플래그입니다.

    표준 서비스는 화이트 보드, 추가 모니터 및 이와 유사한 서비스와 같이 예약 시 예약 가능한 직장 항목에서 사용할 수 있는 기본 조항을 설명합니다. 표준 서비스에 대한 자세한 내용은 표준 서비스를 참조하세요. 이 정보는 표준 서비스 [sn_wsd_rsv_standard_service] 테이블에 있습니다.

    유효한 값은 다음과 같습니다.
    • true: 표준 서비스 정보를 반환합니다.
    • false: 표준 서비스 정보를 반환하지 않습니다.

    데이터 유형: 부울

    기본값: false
    include_reservable_purposes 옵션입니다. 예약 가능한 항목과 관련된 목적을 반환할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약 가능한 항목의 목적을 반환합니다.
    • false: 예약 가능한 항목의 목적을 반환하지 않습니다.

    데이터 유형: 부울

    기본값: false
    include_layouts 응답에서 위치 레이아웃 정보를 반환할지 여부를 나타내는 플래그입니다.

    위치 레이아웃 정보에는 용량, 최대 용량, 준비 및 정리 기간 등이 포함됩니다. 이 정보는 위치 레이아웃 [sn_wsd_rsv_m2m_location_layout] 테이블에 있습니다.

    유효한 값은 다음과 같습니다.
    • 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

    데이터 유형: 문자열
    space_sys_ids 필수 선택한 공간의 쉼표로 구분된 sys_ids입니다.

    데이터 유형: 문자열

    기본값: 빈 값

    헤더

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

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

    기본값: application/json
    컨텐츠-형식 응답 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 5. 응답 헤더
    헤더 설명
    없음

    상태 코드

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

    표 6. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    404예약 가능한 항목을 찾을 수 없습니다.

    WSD 핵심 공간 [sn_wsd_core_spaces] 테이블을 찾아 공간 기록이 있는지 확인합니다.
    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/v2/reservable/list_reservables" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{\"space_sys_ids\":\"3ed3139977220110b3d7be377b5a99d1\",\"reservable_module_sys_id\":\"c31241cedb7650106c731dcd13961917\",\"include_flexible_services\":true,\"include_standard_services\":true,\"include_reservable_purposes\":true,\"include_layouts\":false}" \
--user 'username:'password'

    응답 본문입니다. 이 예제에서는 요청 본문에 나열된 모든 예약 가능 항목에 대한 세부 정보를 반환합니다.

    {
  "result": [
    {
      "sys_id": "3ed3139977220110b3d7be377b5a99d1",
      "external_id": "447b9dfb475a011064062782846d4382",
      "wsd_email": null,
      "name": "A263",
      "title": "A263",
      "description": null,
      "image": null,
      "number": "ROOM0000181",
      "site": {
        "sys_id": "b35f47ffdba05010f342a0da4b961998",
        "display_value": "Italy"
      },
      "campus": {
        "sys_id": "87831b1977220110b3d7be377b5a9946",
        "display_value": ""
      },
      "building": {
        "sys_id": "dea39b1977220110b3d7be377b5a9955",
        "display_value": "",
        "timezone": {
          "value": "",
          "displayValue": ""
        }
      },
      "floor": {
        "sys_id": "68d31f5977220110b3d7be377b5a991b",
        "display_value": ""
      },
      "area": null,
      "capacity": "17",
      "reservable_quantity": "1",
      "location_type": {
        "sys_id": "20713b83eb512010b89bfdfc9c522899",
        "display_value": "Room"
      },
      "order": null,
      "requires_check_in": null,
      "is_reservable": "1",
      "type": "location",
      "moduleType": "Meeting rooms",
      "meetingProviders": [],
      "require_subject": true,
      "allow_invitees": false,
      "display_number_of_attendees": false,
      "display_on_behalf_of": true,
      "display_sensitivity": true,
      "enable_group_reservations": false,
      "allow_reservation_message": false,
      "warn_employee_for_duplicate_reservation": false,
      "enable_reservation_privacy": false,
      "employee_override_privacy": false,
      "tableName": "sn_wsd_core_room",
      "require_approval": false,
      "flexible_services": [
        {
          "allow_only_single_service_item_selection": true,
          "category": "50723fbf07100110c9b36b6e0ad300b4",
          "label": "Space arrangement",
          "description": "This is a service to request a different space configuration as part of a reservation.",
          "sub_category": "chair_layout",
          "title": {
            "edit": "Update Space arrangement for A263",
            "add": "Add Space arrangement for A263"
          },
          "sub_title": "Add a space arrangement item to get started",
          "text": "Select space arrangement item",
          "additional_text": "Select another space arrangement item",
          "currency_code": "GBP",
          "flexible_service": [
            {
              "sub_category": "chair_layout",
              "label": "Chair layout",
              "flexible_service": [
                {
                  "sys_id": "e2ecf7b307500110c9b36b6e0ad30033",
                  "name": "Classroom Style",
                  "short_description": "Rows of tables arranged with all participants facing towards the front of the room",
                  "category": "50723fbf07100110c9b36b6e0ad300b4",
                  "category_label": "Space arrangement",
                  "sub_category": "chair_layout",
                  "sub_category_label": "Chair layout",
                  "image": "08d6ff68d5122110fa9b1500c1d696c5.iix",
                  "quantity_enabled": false,
                  "quantity_required": false,
                  "capacity_enabled": true,
                  "max_capacity": "",
                  "preparation_duration": "1970-01-01 00:15:00",
                  "cleanup_duration": "1970-01-01 00:15:00",
                  "price_per_unit": {
                    "value": 0,
                    "code": "GBP"
                  },
                  "title": {
                    "edit": "Update Space arrangement for A263",
                    "add": "Add Space arrangement for A263"
                  },
                  "sub_title": "Add a space arrangement item to get started",
                  "text": "Select space arrangement item",
                  "additional_text": "Select another space arrangement item"
                },
                {
                  "sys_id": "1cf33fff07100110c9b36b6e0ad30077",
                  "name": "Banquet Rounds",
                  "short_description": "Round tables arranged throughout the room. Participants are seated around the entire perimeter of each table",
                  "category": "50723fbf07100110c9b36b6e0ad300b4",
                  "category_label": "Space arrangement",
                  "sub_category": "chair_layout",
                  "sub_category_label": "Chair layout",
                  "image": "cdc67720d5522110fa9b1500c1d69636.iix",
                  "quantity_enabled": false,
                  "quantity_required": false,
                  "capacity_enabled": true,
                  "max_capacity": "",
                  "preparation_duration": "1970-01-01 00:15:00",
                  "cleanup_duration": "1970-01-01 00:15:00",
                  "price_per_unit": {
                    "value": 0,
                    "code": "GBP"
                  },
                  "title": {
                    "edit": "Update Space arrangement for A263",
                    "add": "Add Space arrangement for A263"
                  },
                  "sub_title": "Add a space arrangement item to get started",
                  "text": "Select space arrangement item",
                  "additional_text": "Select another space arrangement item"
                },
                {
                  "sys_id": "21e2c08407600110c9b36b6e0ad3007c",
                  "name": "Theater Style",
                  "short_description": "Rows of chairs (no tables) arranged with all participants facing towards the front of the room",
                  "category": "50723fbf07100110c9b36b6e0ad300b4",
                  "category_label": "Space arrangement",
                  "sub_category": "chair_layout",
                  "sub_category_label": "Chair layout",
                  "image": "f3d67fa4d5122110fa9b1500c1d6968b.iix",
                  "quantity_enabled": false,
                  "quantity_required": false,
                  "capacity_enabled": true,
                  "max_capacity": "",
                  "preparation_duration": "1970-01-01 00:15:00",
                  "cleanup_duration": "1970-01-01 00:15:00",
                  "price_per_unit": {
                    "value": 0,
                    "code": "GBP"
                  },
                  "title": {
                    "edit": "Update Space arrangement for A263",
                    "add": "Add Space arrangement for A263"
                  },
                  "sub_title": "Add a space arrangement item to get started",
                  "text": "Select space arrangement item",
                  "additional_text": "Select another space arrangement item"
                }
              ]
            }
          ]
        },
        {
          "allow_only_single_service_item_selection": false,
          "category": "c9ab1c89c3500110547e3810a840dd41",
          "label": "Catering",
          "description": "This is a service to request catering as part of a reservation.",
          "sub_category": "drinks",
          "title": {
            "edit": "Update Catering for A263",
            "add": "Add Catering for A263"
          },
          "sub_title": "Add a catering item to get started",
          "text": "Select catering item",
          "additional_text": "Select another catering item",
          "currency_code": "GBP",
          "flexible_service": [
            {
              "sub_category": "drinks",
              "label": "Drinks",
              "flexible_service": [
                {
                  "sys_id": "48d72985c3900110547e3810a840dd7d",
                  "name": "Champagne",
                  "short_description": "",
                  "category": "c9ab1c89c3500110547e3810a840dd41",
                  "category_label": "Catering",
                  "sub_category": "drinks",
                  "sub_category_label": "Drinks",
                  "image": "",
                  "quantity_enabled": true,
                  "quantity_required": false,
                  "capacity_enabled": false,
                  "max_capacity": "",
                  "preparation_duration": 0,
                  "cleanup_duration": 0,
                  "price_per_unit": {
                    "value": 0,
                    "code": "GBP"
                  },
                  "title": {
                    "edit": "Update Catering for A263",
                    "add": "Add Catering for A263"
                  },
                  "sub_title": "Add a catering item to get started",
                  "text": "Select catering item",
                  "additional_text": "Select another catering item"
                }
              ]
            }
          ]
        }
      ],
      "standard_services": [],
      "reservable_purposes": []
    }
  ]
}