WSD 예약 가능 V2 API

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기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/reservable/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 응답에 위치 레이아웃 정보를 반환할지 여부를 나타내는 플래그입니다.

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

    유효한 값은 다음과 같습니다.
    • true: 위치 레이아웃 정보를 반환합니다.
    • false: 위치 레이아웃 정보를 반환하지 않습니다.

    데이터 유형: 부울

    기본값: false

    테이블: 위치 레이아웃[sn_wsd_rsv_m2m_location_layout]
    reservable_module_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: 직원이 예약에 초대 대상자를 추가할 수 없습니다.

    데이터 유형: 부울
    결과.영역 예약 가능한 항목이 위치한 지역입니다.

    데이터 유형: 객체

    "area": {
   "display_value": "String",
   "sys_id": "String"
}

    표: 영역 [sn_wsd_core_area]
    result.area.display_value 영역의 표시 값입니다.

    데이터 유형: 문자열
    result.area.sys_id 연결된 영역 기록의 Sys_id입니다.

    데이터 유형: 문자열
    결과.건물 예약 가능한 건물이 위치한 건물입니다.

    데이터 유형: 객체

    "building": {
  "display_value": "String",
  "sys_id": "String",
  "timezone": {Object}
}

    테이블: 건물 [sn_wsd_core_building]
    result.building.display_value 건물의 표시 값입니다.

    데이터 유형: 문자열
    result.building.sys_id 연결된 건물 기록의 Sys_id입니다.

    데이터 유형: 문자열
    결과.건물.시간대 건물의 표준 시간대에 대한 상세 정보입니다.

    데이터 유형: 객체

    "timezone": {
  "displayValue": "String",
  "value": "String"
}
    result.building.timezone.display_value 연결된 건물이 위치한 시간대의 표시 값입니다.

    데이터 유형: 문자열
    결과.건물.시간대.값 연결된 건물이 있는 시간대의 내부 값입니다.

    데이터 유형: 문자열
    결과.campus 예약 가능한 캠퍼스가 위치한 캠퍼스입니다.

    데이터 유형: 객체

    "campus": {
  "display_value": "String",
  "sys_id": "String"
}

    테이블: 캠퍼스 [sn_wsd_core_campus]
    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로 설정되고 워크플레이스 케이스 관리 플러그인이 설치된 경우에만 입력됩니다. 예약 가능한 항목과 연결된 유연한 서비스에 대한 설명입니다. 상위 유연 서비스와 여러 하위 유연 서비스가 있을 수 있습니다.

    데이터 유형: 객체 배열

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

    테이블: 직장 서비스 항목 [sn_wsd_case_workplace_service_item]
    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 상위 유연한 서비스에 해당하는 유연한 서비스

    데이터 유형: 객체 배열

    "flexible_service": [
  {
    "flexible_service": [Array],
    "label": "String",
    "sub_category": "String"
 }
]

    테이블: 직장 서비스 항목 [sn_wsd_case_workplace_service_item]
    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.용량_활성화 예약에 방 수용 인원을 표시해야 하는지 여부를 나타내는 플래그입니다. true quantity_enabled 로 설정하면 항상 false가 됩니다.
    유효한 값은 다음과 같습니다.
    • 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.name 유연 서비스의 이름입니다.

    데이터 유형: 문자열
    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.단위당가격.값 유연한 서비스의 각 단위에 대한 비용을 code 매개변수에 정의된 통화로 나타낸 것입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.quantity_enabled 예약에 수량 필드를 표시할지 여부를 나타내는 플래그입니다. true capacity_enabled 로 설정하면 항상 false가 됩니다.
    유효한 값은 다음과 같습니다.
    • true: 수량이 표시되어야 합니다.
    • 아니오: 수량이 표시되지 않아야 합니다.

    데이터 유형: 부울
    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.sub_category 유연한 서비스의 하위 범주 이름입니다(예: chair_layout).

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.sub_category_label 의자 레이아웃과 같은 유연한 서비스의 하위 범주 레이블입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.sub_title 하위 유연 서비스의 부제목 이름입니다.

    데이터 유형: 문자열
    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.title UI에서 하위 유연 서비스를 추가하고 편집할 때 사용할 제목에 대한 상세 정보입니다.

    데이터 유형: 객체

    "title": {
  "add": "String",
  "edit": "String"
}
    result.flexible_services.flexible_service입니다.flexible_service.title.add UI에서 하위 유연 서비스를 추가할 때 사용되는 제목입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.title.edit 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에서 상위 유연한 서비스를 편집할 때 사용되는 제목입니다.

    데이터 유형: 문자열
    결과.층 예약 가능한 항목이 위치한 층에 대한 상세 정보입니다.

    데이터 유형: 객체

    "floor": {
  "display_value": "String",
  "sys_id": "String"
}

    테이블: 바닥 [sn_wsd_core_floor]
    result.floor.display_value 예약 가능한 층의 번호를 표시합니다(예: 12).

    데이터 유형: 문자열
    result.floor.sys_id 연결된 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 바닥 [sn_wsd_core_floor]
    결과.이미지 연결된 예약 가능을 나타내는 이미지에 대한 상세 정보입니다.

    데이터 유형: 객체

    "image": {
  "link": "String",
  "sys_id": "String"
}

    테이블: 이미지[db_image]
    result.image.link 예약 가능한 항목을 나타내는 이미지에 연결합니다.

    데이터 유형: 문자열
    result.image.sys_id 연결된 이미지 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 이미지[db_image]
    result.is_reservable 유연한 서비스를 예약할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 유연한 서비스를 예약할 수 있습니다.
    • false: 유연한 서비스를 예약할 수 없습니다.

    데이터 유형: 부울
    결과.레이아웃 매개변수가 include_layouts true로 설정된 경우에만 입력됩니다.

    예약 가능한 레이아웃과 연결된 레이아웃의 목록입니다.

    데이터 유형: 객체 배열

    "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.cleanup_duration 이 레이아웃에 대한 예약 가능 항목을 정리하는 데 걸리는 시간입니다.

    데이터 유형: 숫자

    단위: 밀리초
    결과.레이아웃.이미지 연결된 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 상세 정보입니다.

    데이터 유형: 객체

    "image": {
  "link": "String",
  "sys_id": "String"
}

    테이블: 이미지[db_image]
    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 직장/책상, 카페 또는 체육관과 같은 예약 가능한 위치 유형에 대한 상세 정보입니다.

    데이터 유형: 객체

    "location_type": {
  "display_value": "String",
  "sys_id": "String"
}

    테이블: 공간 유형 [sn_wsd_core_space_type]
    result.location_type.display_value 위치 유형의 표시 값입니다.

    데이터 유형: 문자열
    result.location_type.sys_id 연결된 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 공간 유형 [sn_wsd_core_space_type]
    result.meetingProviders 예약 가능한 가상 회의 제공자에 대한 상세 정보입니다.

    데이터 유형: 객체 배열

    "meetingProviders": [
  {
    "display_value": "String",
    "value": "String"
  }
]

    테이블: 가상 회의 제공자 [sn_wsd_rsv_virtual_meeting_provider]
    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 예약 가능한 상주 사이트에 대한 상세 정보입니다.

    데이터 유형: 객체

    "site": {
  "display_value": "String",
  "sys_id": "String"
}

    테이블: 사이트 [sn_wsd_core_site]
    result.site.display_value 사이트의 표시 값입니다.

    데이터 유형: 문자열
    result.standard_services 매개변수가 include_standard_services true로 설정된 경우에만 입력됩니다.
    플립 차트, 프로젝터 화면, 화이트보드 및 마커와 같은 관련된 표준 서비스입니다.

    데이터 유형: 객체 배열

    "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 연결된 사이트 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사이트 [sn_wsd_core_site]
    result.tableName 예약 가능한 기록이 있는 테이블의 이름입니다.

    데이터 유형: 문자열
    결과.제목 예약 가능한 제목입니다.

    데이터 유형: 문자열
    결과.유형 위치와 같은 예약 가능한 유형입니다.

    데이터 유형: 문자열

    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": []
    }
  ]
}