WSD 예약 가능한 API

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 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/reservable/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}

    주:
    사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 1. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열

    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입니다.

    예약 가능한 모듈은 유사한 유형의 직장 항목을 그룹화합니다.

    예약 가능한 모듈에 대한 자세한 내용은 예약 가능한 모듈 구성을 참조하십시오.

    데이터 유형: 문자열

    테이블: 예약 가능한 모듈 [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: 직원이 예약에 초대 대상자를 추가할 수 없습니다.

    데이터 유형: 부울

    결과.영역 예약 가능한 항목이 위치한 지역입니다.

    데이터 유형: 객체

    "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입니다.

    데이터 유형: 문자열

    결과.이미지 연결된 예약 가능을 나타내는 이미지에 대한 상세 정보입니다.

    데이터 유형: 객체

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

    테이블: 이미지[db_image]

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

    데이터 유형: 문자열

    result.image.sys_id 연결된 이미지 기록의 Sys_id입니다.

    데이터 유형: 문자열

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