WSD 검색 API

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 111분

    • 워크플레이스 서비스 제공 (WSD) 검색 API는 예약 가능, 예약 가능한 모듈, 사용 가능한 교대조와 같은 사용 가능한 위치와 직장 항목을 검색할 수 있는 엔드포인트를 제공합니다.

    이 API에 액세스하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 하며 워크플레이스 안전 관리(sn_wsd_core) 및 워크플레이스 예약 관리(sn_wsd_rsv) 플러그인이 활성화되어 있어야 합니다.

    이 API는 sn_wsd_rsv 네임스페이스에서 실행됩니다.

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

    WSD 검색 - GET /api/sn_wsd_rsv/search/availability

    지정된 예약 가능 항목을 지정된 시간에 사용할 수 있는지 확인합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/search/availability

    기본 URL: /api/sn_wsd_rsv/search/availability

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    표 2. 쿼리 매개변수
    이름 설명
    끝 필수 사용 가능한 예약 가능한 모듈을 검색하는 데 사용할 종료 시간입니다. 이 값은 매개변수에 start 지정된 값보다 나중이어야 합니다.

    데이터 유형: 문자열

    형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss)
    include_reservations_within_days 하루 종일 예약 가능한 각 항목에 대한 응답에서 사용 가능한 시간의 모든 여유 슬롯을 반환할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용 가능한 슬롯을 모두 반환합니다.
    • false: 사용 가능한 슬롯을 모두 반환하지 않습니다.

    데이터 유형: 부울

    기본값: false
    reservable_ids 필수 가용성을 평가할 예약 가능한 sys_ids의 쉼표로 구분된 목록입니다.

    데이터 유형: 문자열

    테이블: 직장 위치 [sn_wsd_core_workplace_location]
    reservation_ids 기존 예약 sys_ids의 쉼표로 구분된 목록입니다. 연결된 예약을 편집하려면 이 매개변수를 전달합니다.

    해당 예약 가능 항목의 이러한 sys_ids에 대해 차단된 시간은 사용 가능한 것으로 처리됩니다.

    데이터 유형: 문자열

    기본값: 없음

    테이블: 직장 예약 [sn_wsd_rsv_reservation]
    reservable_module 필수 검색에 포함할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 유사한 유형의 직장 항목을 그룹화합니다.

    데이터 유형: 문자열

    테이블: 예약 가능한 모듈 [sn_wsd_rsv_reservable_module]
    schedule_view_obj 반환할 일정 뷰에 대한 상세 정보입니다. 하루 이상 걸친 예약에 대해 24시간 가용성 데이터가 필요한 경우 이 객체를 전달합니다. 반환 결과에는 지정된 날짜의 사용 가능한 시간과 예약만 포함됩니다.

    이 기능이 제대로 작동하려면 매개변수 ignore_same_day_validation 를 trueinclude_reservations_within_days로 설정해야 합니다.

    데이터 유형: 객체

    "schedule_view_obj": {
  "schedule_view_date": "String",
  "timezone": "String"
}
    schedule_view_obj.schedule_view_date 예약 가용성 반환을 시작할 날짜입니다. 이 날짜는 매개변수에 schedule_view_obj.timezone 지정된 시간대에 있어야 합니다.

    데이터 유형: 문자열

    형식: YYYY-MM-DD
    schedule_view_obj.timezone 반환할 예약 가용성 데이터를 결정하는 데 사용할 건물 시간대입니다. 예: 미국/태평양

    데이터 유형: 문자열
    Shift 지정된 예약 가능한 모듈이 교대조를 기반으로 하는 경우 필요합니다.
    예약과 연결할 교대조의 Sys_id입니다. 이 매개변수가 전달되면 매개변수가 end 필요하지 않습니다.

    교대조 기반 예약에 대한 자세한 내용은 교대조 기반 예약 사용을 참조하십시오.

    데이터 유형: 문자열

    테이블: 교대조 [sn_wsd_core_shift]
    시작 필수 사용 가능한 예약 가능한 모듈을 검색하는 데 사용할 시작 시간입니다. 이 값은 매개변수에 end 지정된 값보다 이전이어야 합니다.

    데이터 유형: 문자열

    형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss)
    표 3. 요청 본문 매개변수
    이름 설명
    안 함

    헤더

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

    표 4. 요청 헤더
    머리글 설명
    수용 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, 또 application/xml 는, text/xml.

    기본값: application/json
    표 5. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

    응답 본문 매개변수

    이름 설명
    결과 지정된 시간 동안 사용 가능한 모든 재할당 목록입니다.

    데이터 유형: 객체 배열

    "result": [
  {
    "availableTimes": [Array],
    "building": {Object},
    "campus": {Object},
    "email": "String",
    "floor": {Object},
    "is_available": Boolean,
    "name": "String",
    "reservations": [Array],
    "sys_id": "String"
  }
]
    result.availableTimes 연결된 예약 가능 항목을 사용할 수 있는 날짜/시간 목록입니다.

    데이터 유형: 배열
    결과.구축 예약 가능한 건물과 연결된 건물에 대한 상세 정보입니다.

    데이터 유형: 객체

    "building": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.building.display_value 건물의 표시 값입니다.

    데이터 유형: 문자열
    result.building.name 건물의 이름입니다.

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

    데이터 유형: 문자열
    결과.캠퍼스 예약 가능한 캠퍼스와 연결된 캠퍼스에 대한 상세 정보입니다.

    데이터 유형: 객체

    "campus": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.campus.display_value 예약 가능한 항목이 위치한 캠퍼스의 번호를 표시합니다(예: East Bay).

    데이터 유형: 문자열
    result.campus.name 캠퍼스 이름입니다.

    데이터 유형: 문자열
    result.campus.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 캠퍼스 [sn_wsd_core_campus]
    result.email 연결된 예약 가능한 이메일 주소입니다.

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

    데이터 유형: 객체

    "floor": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.floor.display_value 예약 가능한 층의 번호를 표시합니다(예: 12).

    데이터 유형: 문자열
    result.floor.name 예약 가능한 층의 이름입니다.

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

    데이터 유형: 문자열

    테이블: 층 [sn_wsd_core_floor]
    result.is_available 예약 가능 항목을 예약할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약할 수 있습니다.
    • false: 예약할 수 없습니다.

    데이터 유형: 부울
    result.name 예약 가능한 이름입니다.

    데이터 유형: 문자열
    결과.예약 연결된 예약에 대한 상세 정보입니다.

    데이터 유형: 객체 배열

    "reservations": [
  {
    "configuration_item": "String",
    "end": "String",
    "is_collided": Boolean,
    "location": {Object},
    "number": "String",
    "requested_for": {Object},
    "reservation_purpose": {Object},
    "start": "String",
    "state": {Object},
    "subject": "String",
    "sys_id": "String"
  }
]
    result.reservations.configuration_item 예약에 해당하는 구성 항목입니다.

    데이터 유형: 문자열

    테이블: 구성 항목 [cmdb_ci]
    결과.예약.종료 예약 종료 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)
    result.reservations.is_collided 예약이 검색 시작 및 종료 시간과 충돌하는지 여부를 나타내는 플래그입니다.

    이는 연결된 예약 가능한 위치가 지정된 검색 시간 범위에 대해 이미 예약되어 있음을 나타냅니다.

    가능한 값:
    • true: 충돌.
    • false: 충돌이 없습니다.

    데이터 유형: 부울
    결과.예약.위치 예약 위치에 대한 상세 정보입니다.

    데이터 유형: 객체

    "location": {
  "location": "String",
  "timezone": {Object}
}
    result.reservations.location.location 연결된 위치 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 위치 [sn_wsd_core_workplace_location]
    result.reservations.location.timezone 위치와 연결된 시간대에 대한 상세 정보입니다.

    데이터 유형: 객체

    "timezone": {
  "displayValue": "String",
  "value": "String"
}
    result.reservations.location.timezone.displayValue 이 위치가 속한 시간대의 값을 표시합니다.

    데이터 유형: 문자열
    result.reservations.location.timezone.value 이 위치가 속한 시간대의 내부 값입니다.

    데이터 유형: 문자열
    결과.예약.번호 예약 번호입니다.

    데이터 유형: 문자열
    result.reservations.requested_for 예약을 대신하여 요청한 사람에 대한 상세 정보입니다.

    데이터 유형: 객체

    "requested_for": {
  "name": "String",
  "sys_id": "String"
}
    result.reservations.requested_for.name 예약이 요청된 사용자의 이름입니다.

    데이터 유형: 문자열
    result.reservations.requested_for.sys_id 예약이 요청되는 사용자의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]
    result.reservations.reservation_purpose 예약 목적에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservation_purpose": {
  "display_value": "String",
  "value": "String"
}
    result.reservations.reservation_purpose.display_value 회사 회의와 같은 예약 목적의 값을 표시합니다.

    데이터 유형: 문자열
    result.reservations.reservation_purpose.value 예약 목적의 내부 값입니다(예: company_meeting).

    데이터 유형: 문자열
    결과.예약.시작 예약 시작 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)
    결과.예약.상태 해당 위치의 예약 상태에 대한 상세 정보입니다.

    데이터 유형: 객체

    "state": {
  "display_value": "String",
  "value": "String"
}
    result.reservations.state.display_value 예약의 현재 상태에 대한 값(예: 확인됨)을 표시합니다.

    데이터 유형: 문자열
    결과.예약.상태.값 예약의 현재 상태에 대한 내부 값입니다(예: 2).

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

    데이터 유형: 문자열
    result.reservations.sys_id 필수
    예약 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]

    cURL 요청

    다음 코드 예제에서는 이 엔드포인트를 호출하는 방법을 보여 줍니다. 참고: 더 쉽게 읽을 수 있도록 쿼리 매개변수에 줄 바꿈이 추가되었습니다.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/availability?
reservable_module=5db44502dbb650106c731dcd13961937&
start=2023-10-12T11:00:00Z&
end=2023-10-15T12:00:00Z&
reservable_ids=adb35f1977220110b3d7be377b5a99fc&
reservation_ids=undefined&
shift=undefined&
schedule_view_obj={"schedule_view_date":"2023-10-12","timezone":"Europe/Paris"}&
timezone=Europe/Paris&
include_reservations_within_days=true&
ignore_same_day_validation=true&
include_unavailable_items=true"  \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

    반환 결과:

    {
  "result": [
    {
      "sys_id": "fe1f744edb7650106c731dcd139619ca",
      "email": null,
      "name": "Aspen",
      "is_available": true,
      "availableTimes": [
        [
          "2022-04-23 07:00:00",
          "2022-04-23 08:30:00"
        ],
        [
          "2022-04-23 09:30:00",
          "2022-04-23 23:00:00"
        ],
        [
          "2022-04-24 00:00:00",
          "2022-04-24 06:59:59"
        ]
      ],
      "floor": {
        "sys_id": "2f554296dbba10106c731dcd139619ed",
        "display_value": "Floor 2",
        "name": "Floor 2"
      },
      "building": {
        "sys_id": "94e264cedb3650106c731dcd13961919",
        "display_value": "CAL-B1",
        "name": "CAL-B1"
      },
      "campus": {
        "sys_id": "82b2a0cedb3650106c731dcd139619e9",
        "display_value": "California Campus",
        "name": "California Campus"
      },
      "reservations": [
        {
          "sys_id": "5fe65830874bc9106342b846dabb352b",
          "number": "WRES0001001",
          "location": {
            "location": "fe1f744edb7650106c731dcd139619ca",
            "timezone": {
              "value": "US/Pacific",
              "displayValue": "US/Pacific"
            }
          },
          "configuration_item": null,
          "start": "2022-04-23T08:30:00Z",
          "end": "2022-04-23T09:30:00Z",
          "subject": null,
          "reservation_purpose": {
            "value": "meeting",
            "display_value": "Meeting"
          },
          "state": {
            "value": "confirmed",
            "display_value": "Confirmed"
          },
          "is_collided": false,
          "requested_for": {
            "sys_id": "2de07e1887cb89106342b846dabb35fe",
            "name": "Workplace User"
          }
        }
      ]
    }
  ]
}

    WSD 검색 - GET /api/sn_wsd_rsv/search/best_match

    제공된 검색 기준에 따라 가장 적합한 예약 가능한 항목 일치를 검색합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/search/best_match

    기본 URL: /api/sn_wsd_rsv/search/best_match

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    표 8. 쿼리 매개변수
    이름 설명
    best_match_count 반환할 가장 일치하는 예약 가능 항목의 수입니다.

    데이터 유형: 숫자

    기본값: 1
    끝 필수 사용 가능한 예약 가능한 모듈을 검색하는 데 사용할 종료 시간입니다. 이 값은 매개변수에 start 지정된 값보다 나중이어야 합니다.

    데이터 유형: 문자열

    형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss)
    include_reservable_purposes 반환 결과에서 예약 가능한 각 직장 위치를 예약하는 목적을 반환할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약 가능한 목적을 반환합니다.
    • false: 예약 가능한 용도를 반환하지 않습니다.

    데이터 유형: 부울

    기본값: false

    테이블: 예약 가능한 목적 [sn_wsd_rsv_reservable_purpose]
    include_reservations_within_days 하루 종일 예약 가능한 각 항목에 대한 응답에서 사용 가능한 시간의 모든 여유 슬롯을 반환할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용 가능한 슬롯을 모두 반환합니다.
    • false: 사용 가능한 슬롯을 모두 반환하지 않습니다.

    데이터 유형: 부울

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

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

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

    데이터 유형: 부울

    기본값: false
    q 필수 검색 반환 결과를 필터링하는 데 사용할 인코딩된 쿼리입니다. 이 쿼리 내에서 건물 sys_id를 지정해야 하며 층, 면적, 용량, 표준 서비스 및 reservable_purposes과 같은 매개변수를 지정할 수 있습니다.

    숫자인 용량을 제외하고 전달된 모든 매개변수는 sys_ids여야 합니다.

    예: q=building=94e264cedb3650106c731dcd13961919^floorINfc7368cedb3650106c731dcd13961902^capacity>=1^standard_services=55c0818edb7650106c731dcd13961904^reservable_purposes=d6e5c7cd1ba4e01051848489cc4bcb81

    다음 테이블에서 이 정보를 찾을 수 있습니다.
    • 면적: sn_wsd_core_area
    • 건물: sn_wsd_core_building
    • 층: sn_wsd_core_floor
    • 예약 가능한 목적: sn_wsd_rsv_reservable_purpose
    • 표준 서비스: sn_wsd_rsv_standard_service

    데이터 유형: 문자열
    reservable_module 필수 검색에 포함할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 유사한 유형의 직장 항목을 그룹화합니다.

    데이터 유형: 문자열

    테이블: 예약 가능한 모듈 [sn_wsd_rsv_reservable_module]
    시작 필수 사용 가능한 예약 가능한 모듈을 검색하는 데 사용할 시작 시간입니다. 이 값은 매개변수에 end 지정된 값보다 이전이어야 합니다.

    데이터 유형: 문자열

    형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss)
    time_slot 가장 일치하는 예약 가능한 항목을 찾으려는 시간 슬롯 기록의 Sys_id입니다.

    데이터 유형: 문자열

    기본값: 없음

    테이블: 시간 슬롯 [sn_wsd_rsv_time_slot]
    시간대 기본 시간대(예: 유럽/암스테르담)입니다.

    데이터 유형: 문자열

    기본값: 없음
    표 9. 요청 본문 매개변수
    머리글 설명
    안 함

    헤더

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

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

    기본값: application/json
    표 11. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

    응답 본문 매개변수

    이름 설명
    결과 가장 예약 가능한 일치 항목에 대한 결과를 반환합니다.

    데이터 유형: 객체

    "result": { 
  "floorsOfSelectedBuilding": [Array],
  "hasMore": Boolean,
  "nextItemIndex": Number,
  "reservableContainers": [Array],
  "reservableUnits": [Array]
}
    result.floorsOfSelectedBuilding 예약 가능한 층에 대한 상세 정보입니다.

    데이터 유형: 객체 배열

    "floorsOfSelectedBuilding": [
  {
    "display_value": "String",
    "external_id": "String",
    "name": "String",
    "sys_id": "String"
  }
]
    result.floorsOfSelectedBuilding.display_value 예약 가능한 층의 번호를 표시합니다(예: 12).

    데이터 유형: 문자열
    result.floorsOfSelectedBuilding.external_id 층의 외부 식별자입니다.

    데이터 유형: 문자열
    result.floorsOfSelectedBuilding.name 예약 가능한 층의 이름입니다.

    데이터 유형: 문자열
    result.floorsOfSelectedBuilding.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 층 [sn_wsd_core_floor]
    결과.has더 반환 결과에 예약 가능한 항목이 더 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 더 많은 예약 가능 항목 사용 가능
    • false: 더 이상 사용할 수 있는 예약 가능 항목이 없습니다.

    데이터 유형: 부울
    result.nextItemIndex 가져올 다음으로 예약 가능한 기록의 인덱스입니다. 예약 가능한 기록을 통해 페이지를 매김할 때 이 값을 사용합니다.

    데이터 유형: 숫자
    result.reservableContainers selection_type 필드가 컨테이너로 설정된 예약 가능한 모듈에 대해서만 반환됩니다. 컨테이너는 책상 그룹과 같은 유사한 항목을 그룹화한 것입니다.

    데이터 유형: 객체 배열

    "reservableContainers": [
  {
    "building": {Object},
    "campus": {Object},
    "capacity": Number,
    "display_value": "String",
    "floor": {Object},
    "image": {Object}
    "sys_id": "String"
  } 
]
    result.reservableContainers.building 예약 가능한 컨테이너와 연결된 건물에 대한 상세 정보입니다.

    데이터 유형: 객체

    "building": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.reservableContainers.building.display_value 건물의 표시 값입니다.

    데이터 유형: 문자열
    result.reservableContainers.building.name 건물의 이름입니다.

    데이터 유형: 문자열
    result.reservableContainers.building.sys_id 관련 건물 기록의 Sys_id입니다.

    데이터 유형: 문자열
    result.reservableContainers.campus
    예약 가능한 캠퍼스에 대한 상세 정보입니다.

    데이터 유형: 객체

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

    테이블: 캠퍼스 [sn_wsd_core_campus]
    result.reservableContainers.campus.display_value 예약 가능한 항목이 위치한 캠퍼스의 번호를 표시합니다(예: East Bay).

    데이터 유형: 문자열
    result.reservableContainers.campus.name 캠퍼스 이름입니다.

    데이터 유형: 문자열
    result.reservableContainers.campus.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 캠퍼스 [sn_wsd_core_campus]
    result.reservableContainers.capacity 예약 가능한 최대 수용 인원입니다.

    데이터 유형: 숫자
    result.reservableContainers.display_value 예약 가능한 컨테이너의 표시 값입니다.

    데이터 유형: 문자열
    result.reservableContainers.floor 예약 가능한 컨테이너와 연결된 층에 대한 상세 정보입니다.

    데이터 유형: 객체

    "floor": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.reservableContainers.floor.display_value 예약 가능한 층의 번호를 표시합니다(예: 12).

    데이터 유형: 문자열
    result.reservableContainers.floor.name 예약 가능한 층의 이름입니다.

    데이터 유형: 문자열
    result.reservableContainers.floor.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 층 [sn_wsd_core_floor]
    result.reservableContainers.image 연결된 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 상세 정보입니다.

    데이터 유형: 객체

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

    테이블: 이미지 [db_image]
    result.reservableContainers.image.link 이 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 링크입니다.

    데이터 유형: 문자열

    테이블: 이미지 [db_image]
    result.reservableContainers.image.sys_id 연결된 이미지 기록의 Sys_id입니다.

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

    데이터 유형: 문자열

    테이블: 이 테이블이 있는 테이블은 모든 컨테이너 유형에 대해 구성할 수 있습니다. 기본적으로 영역 [sn_wsd_core_area] 테이블에 있습니다.
    result.reservableUnits 지정된 검색 기준과 일치하는 예약 가능한 단위에 대한 상세 정보입니다. 예약 가능한 단위는 책상 또는 의자와 같은 예약 가능한 단일 항목입니다.

    데이터 유형: 객체 배열

    "reservableUnits": [
  {
    "area": "String",
    "availableTimes": [Array],
    "building": {Object},
    "campus": {Object},
    "capacity": "String",
    "defaultPrivacyValue": Boolean,
    "description": "String",
    "email": "String",
    "external_id": "String",
    "floor": {Object},
    "image": {Object},
    "includedInResult": Boolean,
    "is_available": Boolean,
    "is_favorite": Boolean,
    "is_reservable": "String",
    "is_reserved": Boolean,
    "is_selected": Boolean,
    "location_type": {Object},
    "name": "String",
    "number": "String",
    "order": "String",
    "require_approval": Boolean,
    "requires_check_in": Boolean,
    "reservable_quantity": "String",
    "showPrivacyOption": Boolean,
    "site": {Object},
    "standard_services": [Array],
    "tableName": "String",
    "title": "String",
    “reservable_purposes”: [Array],
    "reservations": [Array],
    "sys_id": "String"
  }
]
    result.reservableUnits.area 예약 가능한 모듈이 있는 영역에 대한 상세 정보입니다.

    데이터 유형: 객체

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

    테이블: 영역 [sn_wsd_core_area]
    result.reservableUnits.area.display_value 예약 가능한 모듈 영역의 표시 값입니다.

    데이터 유형: 문자열
    result.reservableUnits.area.sys_id 예약 가능한 항목과 연결된 영역 기록의 Sys_id입니다.

    데이터 유형: 문자열
    result.reservableUnits.availableTimes 연결된 예약 가능 항목을 사용할 수 있는 날짜/시간 목록입니다.

    데이터 유형: 배열
    result.reservableUnits.building 예약 가능한 건물에 대한 상세 정보입니다.

    데이터 유형: 객체

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

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

    데이터 유형: 문자열
    result.reservableUnits.building.sys_id 관련 건물 기록의 Sys_id입니다.

    데이터 유형: 문자열
    결과.예약 가능한 단위.캠퍼스
    예약 가능한 캠퍼스에 대한 상세 정보입니다.

    데이터 유형: 객체

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

    테이블: 캠퍼스 [sn_wsd_core_campus]
    result.reservableUnits.campus.display_value 예약 가능한 항목이 위치한 캠퍼스의 번호를 표시합니다(예: East Bay).

    데이터 유형: 문자열
    result.reservableUnits.campus.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 캠퍼스 [sn_wsd_core_campus]
    result.reservableUnits.capacity 예약 가능한 최대 수용 인원입니다.

    데이터 유형: 숫자
    result.reservableUnits.defaultPrivacyValue 예약 가능한 항목의 기본 개인정보 설정을 나타내는 플래그입니다.

    이러한 개인 정보 설정에 대한 자세한 내용은 위치 개인 정보 보호 설정 및 영향을 참조하세요.

    가능한 값:
    • true: 예약 가능한 항목의 개인정보 설정을 재정의할 수 있습니다.
    • false: 예약 가능한 항목의 개인정보 설정을 재정의할 수 없습니다.

    데이터 유형: 부울
    result.reservableUnits.description 예약 가능한 항목에 대한 간략한 설명입니다.

    데이터 유형: 문자열
    result.reservableUnits.email 예약 가능한 이메일 주소입니다.

    데이터 유형: 문자열
    result.reservableUnits.external_id CMS에 매핑된 공간을 동기화하는 데 사용되는 예약 가능 항목의 외부 ID입니다. 이 값은 이 위치와 연결된 맵이 있는 경우에만 채워집니다.

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

    데이터 유형: 객체

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

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

    데이터 유형: 문자열
    result.reservableUnits.floor.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 층 [sn_wsd_core_floor]
    result.reservableUnits.image 연결된 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 상세 정보입니다.

    데이터 유형: 객체

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

    테이블: 이미지 [db_image]
    result.reservableUnits.image.link 이 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 링크입니다.

    데이터 유형: 문자열

    테이블: 이미지 [db_image]
    result.reservableUnits.image.sys_id 연결된 이미지 기록의 Sys_id입니다.

    데이터 유형: 문자열
    result.reservableUnits.includedInResult 현재 예약 가능 항목이 반환 결과에 포함되는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 반환 결과에 포함됩니다.
    • false: 반환 결과에 포함되지 않습니다.

    데이터 유형: 부울
    result.reservableUnits.is_available 예약 가능 항목을 예약할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약할 수 있습니다.
    • false: 예약할 수 없습니다.

    데이터 유형: 부울
    result.reservableUnits.is_favorite 예약 가능한 항목에 연결된 사용자의 즐겨찾기 중 하나로 플래그가 지정되었는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 즐겨찾기.
    • false: 즐겨찾기가 아닙니다.

    데이터 유형: 부울
    result.reservableUnits.is_reservable 이 예약 가능을 예약할 수 있는지 여부를 나타내는 플래그입니다.
    주:
    쿼리 매개변수가 include_unavailable_items true로 설정되면 사용할 수 없는 위치도 반환됩니다. 이 경우 위치가 이미 예약되어 있으면 매개변수는 is_available false is_reservable 이지만 true입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약할 수 있습니다.
    • false: 예약할 수 없습니다.

    데이터 유형: 부울
    result.reservableUnits.is_reserved 예약 가능 항목이 이미 예약되어 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약할 수 있습니다.
    • false: 이미 예약되어 있습니다.

    데이터 유형: 부울
    result.reservableUnits.is_selected 예약 가능 항목이 이미 예약되어 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약할 수 있습니다.
    • false: 이미 예약되어 있습니다.

    데이터 유형: 부울
    result.reservableUnits.location_type 직장/책상, 카페 또는 체육관과 같은 예약 가능한 위치 유형에 대한 상세 정보입니다.

    데이터 유형: 객체

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

    테이블: 직장 위치 [sn_wsd_core_workplace_location]
    result.reservableUnits.location_type.display_value 위치 유형의 표시 값입니다.

    데이터 유형: 문자열
    result.reservableUnits.location_type.name 지하실, 창고와 같은 위치 유형의 이름입니다. 표시 값과 동일합니다.

    데이터 유형: 문자열
    result.reservableUnits.location_type.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 공간 유형 [sn_wsd_core_space_type]
    result.reservableUnits.name 예약 가능한 이름입니다.

    데이터 유형: 문자열
    result.reservableUnits.number 예약 가능한 항목의 고유 식별자입니다. 이 값은 sys_id보다 사람이 더 읽을 수 있습니다.

    데이터 유형: 문자열
    result.reservableUnits.order 예약 가능한 주문 번호입니다.

    데이터 유형: 숫자
    result.reservableUnits.require_approval 예약 가능한 항목을 예약하려면 승인이 필요한지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 승인이 필요합니다.
    • false: 승인이 필요하지 않습니다.

    데이터 유형: 부울
    result.reservableUnits.requires_check_in 예약 가능 항목에 사용자에게 체크인이 필요한지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 체크인이 필요합니다.
    • false: 체크인이 필요하지 않습니다.

    데이터 유형: 부울
    result.reservableUnits.reservable_purposes 연결된 예약 가능 항목을 예약하는 목적에 대한 상세 정보입니다.

    데이터 유형: 객체 배열

    "reservable_purposes": [
  {
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.reservableUnits.reservable_purposes.이름 예약 가능한 이름입니다.

    데이터 유형: 문자열
    result.reservableUnits.reservable_purposes.short_description 예약 가능한 항목에 대한 간략한 설명입니다.

    데이터 유형: 문자열
    result.reservableUnits.reservable_purposes.sys_id 예약 가능한 목적 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 예약 가능한 목적 [sn_wsd_rsv_reservable_purpose]
    결과.예약 가능한 단위.예약 예약 가능한 예약과 관련된 예약에 대한 상세 정보입니다. 쿼리 매개변수가 예이고 매개변수에 reservation_ids 예약 ID가 포함되어 있는 경우에만 include_reservations_within_days 채워집니다. 이는 이 예약 가능 항목에 대한 예약이 이미 있음을 의미합니다.

    데이터 유형: 객체 배열

    "reservations": [
  {
    "configuration_item": "String",
    "end": "String",
    "is_collided": Boolean,
    "location": {Object},
    "number": "String",
    "requested_for": {Object},
    "reservation_purpose": {Object},
    "start": "String",
    "state": {Object},
    "subject": "String",
    "sys_id": "String"
  }
]
    result.reservableUnits.reservations.configuration_item 예약에 해당하는 구성 항목입니다.

    데이터 유형: 문자열

    테이블: 구성 항목 [cmdb_ci]
    result.reservableUnits.reservations.end 예약 종료 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)
    result.reservableUnits.reservations.is_collided 예약이 검색 시작 및 종료 시간과 충돌하는지 여부를 나타내는 플래그입니다.

    이는 연결된 예약 가능한 위치가 지정된 검색 시간 범위에 대해 이미 예약되어 있음을 나타냅니다.

    가능한 값:
    • true: 충돌.
    • false: 충돌이 없습니다.

    데이터 유형: 부울
    result.reservableUnits.reservations.location 예약 위치에 대한 상세 정보입니다.

    데이터 유형: 객체

    "location": {
  "location": "String",
  "timezone": {Object}
}
    result.reservableUnits.reservations.location.location 연결된 위치 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 위치 [sn_wsd_core_workplace_location]
    result.reservableUnits.reservations.location.timezone 위치와 연결된 시간대에 대한 상세 정보입니다.

    데이터 유형: 객체

    "timezone": {
  "displayValue": "String",
  "value": "String"
}
    result.reservableUnits.reservations.location.timezone.displayValue 이 위치가 속한 시간대의 값을 표시합니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.location.timezone.value 이 위치가 속한 시간대의 내부 값입니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.number 예약 가능한 항목의 고유 식별자입니다. 이 값은 sys_id보다 사람이 더 읽을 수 있습니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.requested_for 예약을 대신하여 요청한 사람에 대한 상세 정보입니다.

    데이터 유형: 객체

    "requested_for": {
  "name": "String",
  "sys_id": "String"
}
    result.reservableUnits.reservations.requested_for.name 예약이 요청된 사용자의 이름입니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.requested_for.sys_id 예약이 요청되는 사용자의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]
    result.reservableUnits.reservations.reservation_purpose 예약 목적에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservation_purpose": {
  "display_value": "String",
  "value": "String"
}
    result.reservableUnits.reservations.reservation_purpose.display_value 회사 회의와 같은 예약 목적의 값을 표시합니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.reservation_purpose.값 예약 목적의 내부 값입니다(예: company_meeting).

    데이터 유형: 문자열
    result.reservableUnits.reservations.start 예약 시작 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)
    result.reservableUnits.reservations.state 해당 위치의 예약 상태에 대한 상세 정보입니다.

    데이터 유형: 객체

    "state": {
  "display_value": "String",
  "value": "String"
}
    result.reservableUnits.reservations.state.display_value 예약의 현재 상태에 대한 값(예: 확인됨)을 표시합니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.state.value 예약의 현재 상태에 대한 내부 값입니다(예: 2).

    데이터 유형: 문자열
    result.reservableUnits.reservations.subject 예약의 제목입니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.sys_id 필수
    예약 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]
    result.reservableUnits.reservable_quantity 연결된 예약 가능 항목을 동시에 예약할 수 있는 최대 횟수입니다. 이 값은 지역에 인접 공간을 할당할 때 사용됩니다.

    데이터 유형: 정수
    result.reservableUnits.showPrivacyOption 직원이 연결된 예약 가능한 항목의 개인정보 설정을 재정의할 수 있는지 여부를 나타내는 플래그입니다.

    이러한 개인 정보 설정에 대한 자세한 내용은 위치 개인 정보 보호 설정 및 영향을 참조하세요.

    유효한 값은 다음과 같습니다.
    • true: 개인정보 설정을 재정의할 수 있습니다.
    • false: 개인정보 설정을 재정의할 수 없습니다.

    데이터 유형: 부울
    result.reservableUnits.site 예약 가능한 항목이 있는 사이트에 대한 상세 정보입니다.

    데이터 유형: 객체

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

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

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

    데이터 유형: 문자열

    테이블: 사이트 [sn_wsd_core_site]
    result.reservableUnits.standard_services
    플립 차트, 프로젝터 스크린, 화이트보드 및 마커와 같은 관련 표준 서비스입니다.

    데이터 유형: 객체 배열

    "standard_services": [
  {
    "font_awesome_icon": "String",
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.reservableUnits.standard_services.font_awesome_icon 표준 서비스와 연결된 썸네일 아이콘의 이름입니다.

    데이터 유형: 문자열
    result.reservableUnits.standard_services.name 표준 서비스와 연결된 썸네일 아이콘의 이름입니다.

    데이터 유형: 문자열
    result.reservableUnits.standard_services.short_description 표준 서비스에 대한 간략한 설명입니다.

    데이터 유형: 문자열
    result.reservableUnits.standard_services.sys_id 표준 서비스 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 표준 서비스 [sn_wsd_rsv_standard_service]
    result.reservableUnits.sys_id 예약 가능한 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 위치 [sn_wsd_core_workplace_location]
    result.reservableUnits.tableName 예약 가능한 기록이 있는 테이블의 이름입니다.

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

    데이터 유형: 문자열

    cURL 요청

    다음 코드 예제에서는 이 엔드포인트를 호출하는 방법을 보여 줍니다.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/best_match?q=building%3D9e0364cedb3650106c731dcd1396192b&start=2023-01-04T07%3A00%3A00Z&time_slot=d5331cf2dbb5f01038e42b24ca961906&end=2023-01-04T17%3A00%3A00Z&best_match_count=1&reservable_module=2b636b7e1b4e60103523ff751a4bcbe2&timezone=Europe%2FAmsterdam" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

    반환 결과:

    {
  "result": {
    "hasMore": false,
    "reservableUnits": [
      {
        "sys_id": "fe1f744edb7650106c731dcd139619ca",
        "external_id": null,
        "email": null,
        "name": "Aspen",
        "title": "Aspen",
        "description": "A room with large windows, dark leather seats and a large wooden table.",
        "image": {
          "sys_id": "41c74902dbb650106c731dcd13961944",
          "link": "41c74902dbb650106c731dcd13961944.iix"
        },
        "number": "ROOM0000903",
        "site": {
          "sys_id": "628eec06db7650106c731dcd139619dd",
          "display_value": "North America"
        },
        "campus": {
          "sys_id": "82b2a0cedb3650106c731dcd139619e9",
          "display_value": "California Campus"
        },
        "building": {
          "sys_id": "94e264cedb3650106c731dcd13961919",
          "display_value": "CAL-B1"
        },
        "floor": {
          "sys_id": "2f554296dbba10106c731dcd139619ed",
          "display_value": "Floor 2"
        },
        "area": null,
        "capacity": "16",
        "reservable_quantity": null,
        "location_type": {
          "sys_id": "20713b83eb512010b89bfdfc9c522899",
          "display_value": "Room",
          "name": "Room"
        },
        "order": null,
        "requires_check_in": null,
        "is_reservable": "1",
        "tableName": "sn_wsd_core_room",
        "require_approval": false,
        "standard_services": [
          {
            "sys_id": "abd0c18edb7650106c731dcd13961965",
            "name": "Projector screen",
            "short_description": "Connect laptop to screen (HDMI and DVI)",
            "font_awesome_icon": "fa-caret-square-o-right"
          }
        ],
        "reservable_purposes": [
          {
            "sys_id": "18f4c3cd1ba4e01051848489cc4bcb82",
            "name": "Board room",
            "short_description": null
          }
        ],
        "is_available": true,
        "reservations": [
          {
            "sys_id": "5fe65830874bc9106342b846dabb352b",
            "number": "WRES0001001",
            "location": {
              "location": "fe1f744edb7650106c731dcd139619ca",
              "timezone": {
                "value": "US/Pacific",
                "displayValue": "US/Pacific"
              }
            },
            "configuration_item": null,
            "start": "2022-04-23T08:30:00Z",
            "end": "2022-04-23T09:30:00Z",
            "subject": null,
            "reservation_purpose": {
              "value": "meeting",
              "display_value": "Meeting"
            },
            "state": {
              "value": "confirmed",
              "display_value": "Confirmed"
            },
            "is_collided": false,
            "requested_for": {
              "sys_id": "2de07e1887cb89106342b846dabb35fe",
              "name": "Workplace User"
            }
          },
          {
            "sys_id": "af075c30874bc9106342b846dabb3572",
            "number": "WRES0001002",
            "location": {
              "location": "fe1f744edb7650106c731dcd139619ca",
              "timezone": {
                "value": "US/Pacific",
                "displayValue": "US/Pacific"
              }
            },
            "configuration_item": null,
            "start": "2022-04-23T23:00:00Z",
            "end": "2022-04-24T00:00:00Z",
            "subject": null,
            "reservation_purpose": {
              "value": "meeting",
              "display_value": "Meeting"
            },
            "state": {
              "value": "confirmed",
              "display_value": "Confirmed"
            },
            "is_collided": false,
            "requested_for": {
              "sys_id": "2de07e1887cb89106342b846dabb35fe",
              "name": "Workplace User"
            }
          }
        ],
        "availableTimes": [
          [
            "2022-04-23 07:00:00",
            "2022-04-23 08:30:00"
          ],
          [
            "2022-04-23 09:30:00",
            "2022-04-23 23:00:00"
          ],
          [
            "2022-04-24 00:00:00",
            "2022-04-24 06:59:59"
          ]
        ],
        "is_favorite": false
      }
    ],
    "reservableContainers": [],
    "nextItemIndex": -1,
    "floorsOfSelectedBuilding": [
      {
        "sys_id": "2f554296dbba10106c731dcd139619ed",
        "display_value": "Floor 2",
        "external_id": null,
        "name": "Floor 2"
      }
    ]
  }
}{
  "result": {
    "hasMore": false,
    "reservableUnits": [
      {
        "sys_id": "32f2a98adb7210106c731dcd13961972",
        "external_id": null,
        "wsd_email": null,
        "name": "B1-03-04",
        "title": "B1-03-04",
        "description": "Desk reserved for the Team-C. After 10am, free to reserve for everyone.",
        "image": {
          "sys_id": "57b42dcadb7210106c731dcd13961945",
          "link": "57b42dcadb7210106c731dcd13961945.iix"
        },
        "number": "SPCE0009018",
        "site": {
          "sys_id": "b17220cedb3650106c731dcd1396197a",
          "display_value": "Western Europe"
        },
        "campus": {
          "sys_id": "44d2e0cedb3650106c731dcd13961988",
          "display_value": "Amsterdam Campus"
        },
        "building": {
          "sys_id": "9e0364cedb3650106c731dcd1396192b",
          "display_value": "AMS-B1"
        },
        "floor": {
          "sys_id": "5373a8cedb3650106c731dcd1396198a",
          "display_value": "Floor 3"
        },
        "area": {
          "sys_id": "410ff04edb7650106c731dcd13961973",
          "display_value": "Desks C1"
        },
        "capacity": "1",
        "reservable_quantity": null,
        "location_type": {
          "sys_id": "5f017383eb512010b89bfdfc9c5228c8",
          "display_value": "Workspace/Desk",
          "name": "Workspace/Desk"
        },
        "order": null,
        "requires_check_in": null,
        "is_reservable": "1",
        "tableName": "sn_wsd_core_space",
        "require_approval": false,
        "is_available": true,
        "reservations": [],
        "availableTimes": [
          [
            "2023-01-04 07:00:00",
            "2023-01-04 17:00:00"
          ]
        ],
        "showPrivacyOption": false,
        "defaultPrivacyValue": false,
        "container": {
          "sys_id": "410ff04edb7650106c731dcd13961973",
          "display_value": "Desks C1",
          "floor": {
            "sys_id": "5373a8cedb3650106c731dcd1396198a",
            "display_value": "Floor 3",
            "name": "Floor 3"
          },
          "building": {
            "sys_id": "9e0364cedb3650106c731dcd1396192b",
            "display_value": "AMS-B1",
            "name": "AMS-B1"
          },
          "campus": {
            "sys_id": "44d2e0cedb3650106c731dcd13961988",
            "display_value": "Amsterdam Campus",
            "name": "Amsterdam Campus"
          },
          "capacity": 6,
          "image": {
            "sys_id": "d52c27b21b8e60103523ff751a4bcb49",
            "link": "d52c27b21b8e60103523ff751a4bcb49.iix"
          }
        },
        "includedInResult": true,
        "is_favorite": true
      }
    ],
    "reservableContainers": [
      {
        "sys_id": "410ff04edb7650106c731dcd13961973",
        "display_value": "Desks C1",
        "floor": {
          "sys_id": "5373a8cedb3650106c731dcd1396198a",
          "display_value": "Floor 3",
          "name": "Floor 3"
        },
        "building": {
          "sys_id": "9e0364cedb3650106c731dcd1396192b",
          "display_value": "AMS-B1",
          "name": "AMS-B1"
        },
        "campus": {
          "sys_id": "44d2e0cedb3650106c731dcd13961988",
          "display_value": "Amsterdam Campus",
          "name": "Amsterdam Campus"
        },
        "capacity": 6,
        "image": {
          "sys_id": "d52c27b21b8e60103523ff751a4bcb49",
          "link": "d52c27b21b8e60103523ff751a4bcb49.iix"
        }
      }
    ],
    "nextItemIndex": -1,
    "floorsOfSelectedBuilding": [
      {
        "sys_id": "5373a8cedb3650106c731dcd1396198a",
        "display_value": "Floor 3",
        "external_id": null,
        "name": "Floor 3"
      }
    ]
  }

    WSD 검색 - GET /api/sn_wsd_rsv/search/overlapping_reservation

    전달된 매개변수를 기반으로 중복된 예약이 있는지 확인합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/search/overlapping_reservation

    기본 URL: /api/sn_wsd_rsv/search/overlapping_reservation

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    표 14. 쿼리 매개변수
    이름 설명
    끝 필수 중복된 예약을 확인하는 데 사용할 종료 시간입니다.

    데이터 유형: 문자열

    형식: YYYY-MM-DDTHH:MM:SSZ
    recurring_pattern 예약의 반복 패턴에 대한 상세 정보입니다.

    데이터 유형: 객체

    "recurring_pattern": {
  "duration": Number,
  "options": {Object},
  "repeats": "String",
  "startDate":"String"
}
    recurring_pattern.duration 검사할 시간입니다.

    데이터 유형: 숫자

    단위: 초
    recurring_pattern.options 반복 예약과 관련된 옵션에 대한 상세 정보입니다.

    데이터 유형: 객체

    "options": {
  "count": Number,
  "daysOfWeek": "String",
  "every": Number
}
    recurring_pattern.옵션.카운트 패턴이 반복되는 횟수입니다.

    데이터 유형: 숫자
    recurring_pattern.options.daysOfWeek 중복을 확인할 요일입니다.
    유효한 값은 다음과 같습니다.
    • 1 = 월요일
    • 2 = 화요일
    • 3 = 수요일
    • 4 = 목요일
    • 5 = 금요일
    • 6 = 토요일
    • 7 = 일요일

    예를 들어 화요일, 목요일, 금요일을 지정하려면 245(구분 기호 없음)를 전달합니다.

    데이터 유형: 문자열
    recurring_pattern.options.every 검사할 패턴 반복 간격입니다. 예를 들어 이 값이 2이면 격일 또는 격주와 같이 매개변수의 repeats 선택에 따라 반복 패턴을 확인합니다.

    데이터 유형: 숫자
    recurring_pattern.options.repeats 예약 중복 확인을 위한 반복 패턴입니다.
    가능한 값: (대/소문자 구분)
    • 매일
    • 월별
    • 주별
    • 매년

    데이터 유형: 문자열
    reservable_id 중복된 예약을 확인하기 위한 예약 가능한 모듈의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 예약 가능한 모듈 [sn_wsd_rsv_reservable_module]
    reservation_id 중복을 확인할 예약의 Sys_id입니다. 이 값은 다중/그룹 상위의 편집 플로우에 필요합니다.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]
    shift_info_object 중복을 확인할 교대조의 상세 정보입니다.

    교대조 기반 예약에 대한 자세한 내용은 교대조 기반 예약 사용을 참조하십시오.

    데이터 유형: 객체

    "shift_info_object": {
  "applyToShift": Boolean,
  "shift": "String",
  "timezone": "String"
}
    shift_info_object.applyToShift 예약 가능한 모듈에 대해 교대조 기반 예약이 활성화되어 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 교대조 기반 예약을 허용합니다.
    • false: 교대조 기반 예약을 허용하지 않습니다.

    데이터 유형: 부울
    shift_info_object.shift 예약과 연결할 교대조의 Sys_id입니다. 이 매개변수가 전달되면 매개변수가 end 필요하지 않습니다.

    데이터 유형: 문자열

    테이블:Shift [sn_wsd_core_shift]
    shift_info_object.timezone 중복을 확인할 교대조의 시간대입니다.

    데이터 유형: 문자열
    시작 필수 중복된 예약을 확인하는 데 사용할 시작 시간입니다.

    데이터 유형: 문자열

    형식: YYY-MM-DDTHH:MM:SSZ
    user_id 필수 중복된 예약을 확인할 사용자의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]
    표 15. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json
    표 17. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

    응답 본문 매개변수(JSON 또는 XML)

    이름 설명
    결과 중복 검사 결과에 대한 상세 정보입니다.

    데이터 유형: 객체

    "results": {
  "isOverlapped": Boolean,
  "reservableId": "String"
}
    results.isOverlapped 중복된 예약이 있는지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.

    • true: 중복된 예약이 있습니다.
    • false: 중복된 예약이 없습니다.

    데이터 유형: 부울
    results.reservableId 그룹 예약의 경우 중복이 발생하는 예약 가능 항목의 sys_id입니다.

    데이터 유형: 문자열

    cURL 요청

    다음 코드 예제에서는 AND end 매개변수로 start 표시된 특정 기간 및 특정 기간에 대한 예약 중복을 확인하는 방법을 보여 줍니다.

    curl "http://instance.servicenow.com/api/sn_wsd_rsv/search/overlapping_reservation?user_id=2e617fecc3d365101e38b23bb00131ec&end=2023-06-19T8:00:00Z&start=2023-06-19T07:00:00Z" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    반환 결과:

    {
"results": {
  "isOverlapped": True,
  "reservableId": ""
  }
}

    WSD 검색 - GET /api/sn_wsd_rsv/search/reserved able

    지정된 예약 가능한 모델 구성을 사용하여 사용 가능한 예약 가능한 항목을 검색합니다.

    URL 형식

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

    기본 URL: /api/sn_wsd_rsv/search/reservable

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    표 20. 쿼리 매개변수
    이름 설명
    끝 필수 사용 가능한 예약 가능한 모듈을 검색하는 데 사용할 종료 시간입니다. 이 값은 매개변수에 start 지정된 값보다 나중이어야 합니다.

    데이터 유형: 문자열

    형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss)
    exclude_reservables검색 결과에서 제외할 하나 이상의 예약 가능 sys_ids 목록입니다.

    데이터 유형: 문자열 또는 배열

    테이블: 이러한 sys_ids이 위치한 테이블은 예약 가능한 모듈[sn_wsd_rsv_reservable_module] 테이블의 reservable_table 필드에 지정됩니다. 공간 [sn_wsd_core_space] 또는 회의실 [sn_wsd_core_room] 테이블일 수 있습니다.
    ignore_same_day_validation 예약 검색이 시작 및 종료 매개변수 간의 날짜 확인 변경을 무시하는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 변경 날짜 확인을 무시합니다.
    • false: 변경 날짜 확인을 무시하지 마십시오.

    데이터 유형: 부울

    기본값: false
    include_reservable_purposes 반환 결과에서 예약 가능한 각 직장 위치를 예약하는 목적을 반환할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약 가능한 목적을 반환합니다.
    • false: 예약 가능한 용도를 반환하지 않습니다.

    데이터 유형: 부울

    기본값: false

    테이블: 예약 가능한 목적 [sn_wsd_rsv_reservable_purpose]
    include_reservations_within_days 하루 종일 예약 가능한 각 항목에 대한 응답에서 사용 가능한 시간의 모든 여유 슬롯을 반환할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용 가능한 슬롯을 모두 반환합니다.
    • false: 사용 가능한 슬롯을 모두 반환하지 않습니다.

    데이터 유형: 부울

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

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

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

    데이터 유형: 부울

    기본값: false
    near_by_location_id 매개변수가 rsv_pathbrowse_near_a_person로 설정된 경우 필요합니다. 인코딩된 쿼리에 사용할 위치의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 위치 [sn_wsd_core_workplace_location]
    인접

    rsv_path 매개변수가 browse_by_neighborhood로 설정된 경우 필요합니다.

    sn_wsd_spc_mgmt_neighborhood(공간 관리) 플러그인이 활성화된 경우에만 사용할 수 있습니다.

    인코딩된 쿼리에 사용할 인접 기록의 Sys_id입니다.

    인접 공간 예약에 대한 자세한 내용은 다음 문서를 참조하십시오 Create neighborhood reservations.

    데이터 유형: 문자열

    테이블: 인접 [sn_wsd_spcmgmt_neighborhood]
    next_item_index 검색할 다음 항목의 인덱스입니다. 반환 결과를 페이지 매김할 때 이 매개변수를 전달합니다.

    데이터 유형: 숫자

    기본값: 0
    page_size 반환 결과에서 반환할 최대 기록 수입니다.

    데이터 유형: 숫자

    기본값: 6
    q 필수 검색 반환 결과를 필터링하는 데 사용할 인코딩된 쿼리입니다. 이 쿼리 내에서 건물 sys_id를 지정해야 하며 층, 면적, 용량, 표준 서비스 및 reservable_purposes과 같은 매개변수를 지정할 수 있습니다.

    숫자인 용량을 제외하고 전달된 모든 매개변수는 sys_ids여야 합니다.

    예: q=building=94e264cedb3650106c731dcd13961919^floorINfc7368cedb3650106c731dcd13961902^capacity>=1^standard_services=55c0818edb7650106c731dcd13961904^reservable_purposes=d6e5c7cd1ba4e01051848489cc4bcb81

    다음 테이블에서 이 정보를 찾을 수 있습니다.
    • 면적: sn_wsd_core_area
    • 건물: sn_wsd_core_building
    • 층: sn_wsd_core_floor
    • 예약 가능한 목적: sn_wsd_rsv_reservable_purpose
    • 표준 서비스: sn_wsd_rsv_standard_service

    데이터 유형: 문자열
    reservable_module 필수 검색에 포함할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 유사한 유형의 직장 항목을 그룹화합니다.

    데이터 유형: 문자열

    테이블: 예약 가능한 모듈 [sn_wsd_rsv_reservable_module]
    reservation_ids 기존 예약 sys_ids의 쉼표로 구분된 목록입니다. 연결된 예약을 편집하려면 이 매개변수를 전달합니다.

    해당 예약 가능 항목의 이러한 sys_ids에 대해 차단된 시간은 사용 가능한 것으로 처리됩니다.

    데이터 유형: 문자열

    기본값: 없음

    테이블: 직장 예약 [sn_wsd_rsv_reservation]
    rsv_path 검색에 적용할 예약 경로입니다.
    유효한 값은 다음과 같습니다.
    • browse_all: 모든 예약 가능한 항목을 검색합니다.
    • browse_by_area: 특정 위치 근처의 예약 가능 항목을 검색합니다. 영역 식별자는 인코딩된 쿼리(매개변수)q 에 전달되어야 합니다.
    • browse_by_neighborhood: 매개변수에 지정된 인접 근처의 예약 가능한 항목을 검색합니다 neighborhood .
    • browse_near_a_person: 매개변수에 지정된 사람의 직장 위치 근처에서 예약 가능한 항목을 검색합니다 near_by_location_id .

    데이터 유형: 문자열

    기본값: browse_all
    schedule_view_obj 반환할 일정 뷰에 대한 상세 정보입니다. 하루 이상 걸친 예약에 대해 24시간 가용성 데이터가 필요한 경우 이 객체를 전달합니다. 반환 결과에는 지정된 날짜의 사용 가능한 시간과 예약만 포함됩니다.

    이 기능이 제대로 작동하려면 매개변수 ignore_same_day_validation 를 trueinclude_reservations_within_days로 설정해야 합니다.

    데이터 유형: 객체

    "schedule_view_obj": {
  "schedule_view_date": "String",
  "timezone": "String"
}
    schedule_view_obj.schedule_view_date 예약 가용성 반환을 시작할 날짜입니다. 이 날짜는 매개변수에 schedule_view_obj.timezone 지정된 시간대에 있어야 합니다.

    데이터 유형: 문자열

    형식: YYYY-MM-DD
    schedule_view_obj.timezone 반환할 예약 가용성 데이터를 결정하는 데 사용할 건물 시간대입니다. 예: 미국/태평양

    데이터 유형: 문자열
    시작 필수 사용 가능한 예약 가능한 모듈을 검색하는 데 사용할 시작 시간입니다. 이 값은 매개변수에 end 지정된 값보다 이전이어야 합니다.

    데이터 유형: 문자열

    형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss)
    Shift
    예약과 연결할 교대조의 Sys_id입니다. 이 매개변수가 전달되면 매개변수가 end 필요하지 않습니다.

    교대조 기반 예약에 대한 자세한 내용은 교대조 기반 예약 사용을 참조하십시오.

    데이터 유형: 문자열

    테이블: 교대조 [sn_wsd_core_shift]
    sort_by 반환된 예약 가능한 항목의 원하는 정렬 순서입니다.
    유효한 값은 다음과 같습니다.
    • a_z: 오름차순 정렬 순서입니다.
    • favorites_first: 사용자가 가장 좋아하는 직장 예약 가능한 항목을 기준으로 먼저 정렬되고 나머지는 오름차순으로 정렬됩니다.
    • z_a: 내림차순 정렬 순서입니다.

    데이터 유형: 문자열

    기본값: a_z
    시간대 기본 시간대(예: 유럽/암스테르담)입니다.

    데이터 유형: 문자열

    기본값: 없음
    표 21. 요청 본문 매개변수
    이름 설명
    안 함

    헤더

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

    표 22. 요청 헤더
    머리글 설명
    수용 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, 또 application/xml 는, text/xml.

    기본값: application/json
    표 23. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

    응답 본문 매개변수

    이름 설명
    결과 지정된 검색에 대한 결과를 반환합니다.

    데이터 유형: 객체

    "result": { 
  "filter": {Object},
  "hasMore": Boolean,
  "nextFavIndex": Number,
  "nextItemIndex": Number,
  "reservableContainers": [Array],
  "reservableUnits": [Array],
  "totalProcessed": Number
}
    결과.필터 층, 표준 서비스 및 예약 가능한 항목의 예약 가능 목적에 대한 상세 정보입니다. 또는 include_reservable_purposes 매개변수가 include_standard_services false standard_servicesreservable_purposes 로 설정되고 빈 배열인 경우.

    데이터 유형: 객체

    "filter": {
   "floors": [Array],
   "reservable_purposes": [Array],
   "standard_services": [Array]
}
    결과.필터.층
    예약 가능한 층에 대한 상세 정보입니다.

    데이터 유형: 객체

    "floors": [
  {
    "display_value": "String",
    "sys_id": "String"
  }
]
    result.filter.floors.display_value 예약 가능한 층의 번호를 표시합니다(예: 12).

    데이터 유형: 문자열
    result.filter.floors.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 층 [sn_wsd_core_floor]
    result.filter.standard_services 매개변수가 include_standard_services true로 설정된 경우에만 채워집니다.
    플립 차트, 프로젝터 스크린, 화이트보드 및 마커와 같은 관련 표준 서비스입니다.

    데이터 유형: 객체 배열

    "standard_services": [
  {
    "font_awesome_icon": "String",
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.filter.standard_services.font_awesome_icon 표준 서비스와 연결된 썸네일 아이콘의 이름입니다.

    데이터 유형: 문자열
    result.filter.standard_services.name 표준 서비스의 이름입니다.

    데이터 유형: 문자열
    result.filter.standard_services.short_description 표준 서비스에 대한 간략한 설명입니다.

    데이터 유형: 문자열
    result.filter.standard_services.sys_id 표준 서비스 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 표준 서비스 [sn_wsd_rsv_standard_service]
    result.filter.reservable_purposes 연결된 예약 가능 항목을 예약하는 목적에 대한 상세 정보입니다.

    데이터 유형: 객체 배열

    "reservable_purposes": [
  {
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.filter.reservable_purposes.name 예약 가능한 이름입니다.

    데이터 유형: 문자열
    result.filter.reservable_purposes.short_description 예약 가능한 항목에 대한 간략한 설명입니다.

    데이터 유형: 문자열
    result.filter.reservable_purposes.sys_id 예약 가능한 목적 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 예약 가능한 목적 [sn_wsd_rsv_reservable_purpose]
    결과.has더 반환 결과에 예약 가능한 항목이 더 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 더 많은 예약 가능 항목 사용 가능
    • false: 더 이상 사용할 수 있는 예약 가능 항목이 없습니다.

    데이터 유형: 부울
    result.nextFavIndex 사용자가 예약할 수 있는 다음 즐겨찾기에 대한 인덱스입니다. 사용자가 즐겨찾는 예약 가능 항목을 통해 페이지를 매김할 때 이 값을 사용합니다.

    데이터 유형: 숫자
    result.nextItemIndex 가져올 다음으로 예약 가능한 기록의 인덱스입니다. 예약 가능한 기록을 통해 페이지를 매김할 때 이 값을 사용합니다.

    데이터 유형: 숫자
    result.reservableContainers selection_type 필드가 컨테이너로 설정된 예약 가능한 모듈에 대해서만 반환됩니다. 컨테이너는 책상 그룹과 같은 유사한 항목을 그룹화한 것입니다.

    데이터 유형: 객체 배열

    "reservableContainers": [
  {
    "building": {Object},
    "campus": {Object},
    "capacity": Number,
    "display_value": "String",
    "floor": {Object},
    "image": {Object}
    "sys_id": "String"
  } 
]
    result.reservableContainers.building 예약 가능한 컨테이너와 연결된 건물에 대한 상세 정보입니다.

    데이터 유형: 객체

    "building": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.reservableContainers.building.display_value 건물의 표시 값입니다.

    데이터 유형: 문자열
    result.reservableContainers.building.name 건물의 이름입니다.

    데이터 유형: 문자열
    result.reservableContainers.building.sys_id 관련 건물 기록의 Sys_id입니다.

    데이터 유형: 문자열
    result.reservableContainers.campus
    예약 가능한 캠퍼스에 대한 상세 정보입니다.

    데이터 유형: 객체

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

    테이블: 캠퍼스 [sn_wsd_core_campus]
    result.reservableContainers.campus.display_value 예약 가능한 항목이 위치한 캠퍼스의 번호를 표시합니다(예: East Bay).

    데이터 유형: 문자열
    result.reservableContainers.campus.name 캠퍼스 이름입니다.

    데이터 유형: 문자열
    result.reservableContainers.campus.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 캠퍼스 [sn_wsd_core_campus]
    result.reservableContainers.capacity 예약 가능한 최대 수용 인원입니다.

    데이터 유형: 숫자
    result.reservableContainers.display_value 예약 가능한 컨테이너의 표시 값입니다.

    데이터 유형: 문자열
    result.reservableContainers.floor 예약 가능한 컨테이너와 연결된 층에 대한 상세 정보입니다.

    데이터 유형: 객체

    "floor": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.reservableContainers.floor.display_value 예약 가능한 층의 번호를 표시합니다(예: 12).

    데이터 유형: 문자열
    result.reservableContainers.floor.name 예약 가능한 층의 이름입니다.

    데이터 유형: 문자열
    result.reservableContainers.floor.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 층 [sn_wsd_core_floor]
    result.reservableContainers.image 이 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 링크입니다.

    데이터 유형: 문자열

    테이블: 이미지 [db_image]
    result.reservableContainers.image.link 이 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 링크입니다.

    데이터 유형: 문자열

    테이블: 이미지 [db_image]
    result.reservableContainers.image.sys_id 연결된 이미지 기록의 Sys_id입니다.

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

    데이터 유형: 문자열

    테이블: 이 테이블이 있는 테이블은 모든 컨테이너 유형에 대해 구성할 수 있습니다. 기본적으로 영역 [sn_wsd_core_area] 테이블에 있습니다.
    result.reservableUnits 지정된 검색 기준과 일치하는 예약 가능한 단위에 대한 상세 정보입니다. 예약 가능한 단위는 책상 또는 의자와 같은 예약 가능한 단일 항목입니다.

    데이터 유형: 객체 배열

    "reservableUnits": [
  {
    "area": "String",
    "availableTimes": [Array],
    "building": {Object},
    "campus": {Object},
    "capacity": "String",
    "defaultPrivacyValue": Boolean,
    "description": "String",
    "email": "String",
    "external_id": "String",
    "floor": {Object},
    "image": {Object},
    "includedInResult": Boolean,
    "is_available": Boolean,
    "is_favorite": Boolean,
    "is_reservable": "String",
    "is_reserved": Boolean,
    "is_selected": Boolean,
    "location_type": {Object},
    "name": "String",
    "number": "String",
    "order": "String",
    "require_approval": Boolean,
    "requires_check_in": Boolean,
    "reservable_quantity": "String",
    "showPrivacyOption": Boolean,
    "site": {Object},
    "standard_services": [Array],
    "tableName": "String",
    "title": "String",
    “reservable_purposes”: [Array],
    "reservations": [Array],
    "sys_id": "String"
  }
]
    result.reservableUnits.area 예약 가능한 모듈이 있는 영역에 대한 상세 정보입니다.

    데이터 유형: 객체

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

    테이블: 영역 [sn_wsd_core_area]
    result.reservableUnits.area.display_value 예약 가능한 모듈 영역의 표시 값입니다.

    데이터 유형: 문자열
    result.reservableUnits.area.sys_id 예약 가능한 항목과 연결된 영역 기록의 Sys_id입니다.

    데이터 유형: 문자열
    result.reservableUnits.availableTimes 연결된 예약 가능 항목을 사용할 수 있는 날짜/시간 목록입니다.

    데이터 유형: 배열
    result.reservableUnits.building 예약 가능한 건물에 대한 상세 정보입니다.

    데이터 유형: 객체

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

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

    데이터 유형: 문자열
    result.reservableUnits.building.sys_id 관련 건물 기록의 Sys_id입니다.

    데이터 유형: 문자열
    결과.예약 가능한 단위.캠퍼스
    예약 가능한 캠퍼스에 대한 상세 정보입니다.

    데이터 유형: 객체

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

    테이블: 캠퍼스 [sn_wsd_core_campus]
    result.reservableUnits.campus.display_value 예약 가능한 항목이 위치한 캠퍼스의 번호를 표시합니다(예: East Bay).

    데이터 유형: 문자열
    result.reservableUnits.campus.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 캠퍼스 [sn_wsd_core_campus]
    result.reservableUnits.capacity 예약 가능한 최대 수용 인원입니다.

    데이터 유형: 숫자
    result.reservableUnits.description 예약 가능한 항목에 대한 간략한 설명입니다.

    데이터 유형: 문자열
    result.reservableUnits.email 예약 가능한 이메일 주소입니다.

    데이터 유형: 문자열
    result.reservableUnits.external_id CMS에 매핑된 공간을 동기화하는 데 사용되는 예약 가능 항목의 외부 ID입니다. 이 값은 이 위치와 연결된 맵이 있는 경우에만 채워집니다.

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

    데이터 유형: 객체

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

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

    데이터 유형: 문자열
    result.reservableUnits.floor.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 층 [sn_wsd_core_floor]
    result.reservableUnits.image 연결된 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 상세 정보입니다.

    데이터 유형: 객체

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

    테이블: 이미지 [db_image]
    result.reservableUnits.image.link 이 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 링크입니다.

    데이터 유형: 문자열

    테이블: 이미지 [db_image]
    result.reservableUnits.image.sys_id 연결된 이미지 기록의 Sys_id입니다.

    데이터 유형: 문자열
    result.reservableUnits.includedInResult 현재 예약 가능 항목이 반환 결과에 포함되는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 반환 결과에 포함됩니다.
    • false: 반환 결과에 포함되지 않습니다.

    데이터 유형: 부울
    result.reservableUnits.is_available 예약 가능 항목을 예약할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약할 수 있습니다.
    • false: 예약할 수 없습니다.

    데이터 유형: 부울
    result.reservableUnits.is_favorite 예약 가능한 항목에 연결된 사용자의 즐겨찾기 중 하나로 플래그가 지정되었는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 즐겨찾기.
    • false: 즐겨찾기가 아닙니다.

    데이터 유형: 부울
    result.reservableUnits.is_reservable 이 예약 가능을 예약할 수 있는지 여부를 나타내는 플래그입니다.
    주:
    쿼리 매개변수가 include_unavailable_items true로 설정되면 사용할 수 없는 위치도 반환됩니다. 이 경우 위치가 이미 예약되어 있으면 매개변수는 is_available false is_reservable 이지만 true입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약할 수 있습니다.
    • false: 예약할 수 없습니다.

    데이터 유형: 부울
    result.reservableUnits.is_reserved 예약 가능 항목이 이미 예약되어 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약할 수 있습니다.
    • false: 이미 예약되어 있습니다.

    데이터 유형: 부울
    result.reservableUnits.is_selected 예약 가능 항목이 이미 예약되어 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약할 수 있습니다.
    • false: 이미 예약되어 있습니다.

    데이터 유형: 부울
    result.reservableUnits.location_type 직장/책상, 카페 또는 체육관과 같은 예약 가능한 위치 유형에 대한 상세 정보입니다.

    데이터 유형: 객체

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

    테이블: 직장 위치 [sn_wsd_core_workplace_location]
    result.reservableUnits.location_type.display_value 위치 유형의 표시 값입니다.

    데이터 유형: 문자열
    result.reservableUnits.location_type.name 지하실, 창고와 같은 위치 유형의 이름입니다. 표시 값과 동일합니다.

    데이터 유형: 문자열
    result.reservableUnits.location_type.sys_id 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 공간 유형 [sn_wsd_core_space_type]
    result.reservableUnits.name 예약 가능한 이름입니다.

    데이터 유형: 문자열
    result.reservableUnits.number 예약 가능한 항목의 고유 식별자입니다. 이 값은 sys_id보다 사람이 더 읽을 수 있습니다.

    데이터 유형: 문자열
    result.reservableUnits.order 예약 가능한 주문 번호입니다.

    데이터 유형: 숫자
    result.reservableUnits.require_approval 예약 가능한 항목을 예약하려면 승인이 필요한지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 승인이 필요합니다.
    • false: 승인이 필요하지 않습니다.

    데이터 유형: 부울
    result.reservableUnits.requires_check_in 예약 가능 항목에 사용자에게 체크인이 필요한지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 체크인이 필요합니다.
    • false: 체크인이 필요하지 않습니다.

    데이터 유형: 부울
    result.reservableUnits.reservable_purposes 연결된 예약 가능 항목을 예약하는 목적에 대한 상세 정보입니다.

    데이터 유형: 객체 배열

    "reservable_purposes": [
  {
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.reservableUnits.reservable_purposes.이름 예약 가능한 이름입니다.

    데이터 유형: 문자열
    result.reservableUnits.reservable_purposes.short_description 예약 가능한 항목에 대한 간략한 설명입니다.

    데이터 유형: 문자열
    result.reservableUnits.reservable_purposes.sys_id 예약 가능한 목적 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 예약 가능한 목적 [sn_wsd_rsv_reservable_purpose]
    결과.예약 가능한 단위.예약 예약 가능한 예약과 관련된 예약에 대한 상세 정보입니다. 쿼리 매개변수가 예이고 매개변수에 reservation_ids 예약 ID가 포함되어 있는 경우에만 include_reservations_within_days 채워집니다. 이는 이 예약 가능 항목에 대한 예약이 이미 있음을 의미합니다.

    데이터 유형: 객체 배열

    "reservations": [
  {
    "configuration_item": "String",
    "end": "String",
    "is_collided": Boolean,
    "location": {Object},
    "number": "String",
    "requested_for": {Object},
    "reservation_purpose": {Object},
    "start": "String",
    "state": {Object},
    "subject": "String",
    "sys_id": "String"
  }
]
    result.reservableUnits.reservations.configuration_item 예약에 해당하는 구성 항목입니다.

    데이터 유형: 문자열

    테이블: 구성 항목 [cmdb_ci]
    result.reservableUnits.reservations.end 예약 종료 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)
    result.reservableUnits.reservations.is_collided 예약이 검색 시작 및 종료 시간과 충돌하는지 여부를 나타내는 플래그입니다.

    이는 연결된 예약 가능한 위치가 지정된 검색 시간 범위에 대해 이미 예약되어 있음을 나타냅니다.

    가능한 값:
    • true: 충돌.
    • false: 충돌이 없습니다.

    데이터 유형: 부울
    result.reservableUnits.reservations.location 예약 위치에 대한 상세 정보입니다.

    데이터 유형: 객체

    "location": {
  "location": "String",
  "timezone": {Object}
}
    result.reservableUnits.reservations.location.location 연결된 위치 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 위치 [sn_wsd_core_workplace_location]
    result.reservableUnits.reservations.location.timezone 위치와 연결된 시간대에 대한 상세 정보입니다.

    데이터 유형: 객체

    "timezone": {
  "displayValue": "String",
  "value": "String"
}
    result.reservableUnits.reservations.location.timezone.displayValue 이 위치가 속한 시간대의 값을 표시합니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.location.timezone.value 이 위치가 속한 시간대의 내부 값입니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.number 예약 가능한 항목의 고유 식별자입니다. 이 값은 sys_id보다 사람이 더 읽을 수 있습니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.requested_for 예약을 대신하여 요청한 사람에 대한 상세 정보입니다.

    데이터 유형: 객체

    "requested_for": {
  "name": "String",
  "sys_id": "String"
}
    result.reservableUnits.reservations.requested_for.name 예약이 요청된 사용자의 이름입니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.requested_for.sys_id 예약이 요청되는 사용자의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]
    result.reservableUnits.reservations.reservation_purpose 예약 목적에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservation_purpose": {
  "display_value": "String",
  "value": "String"
}
    result.reservableUnits.reservations.reservation_purpose.display_value 회사 회의와 같은 예약 목적의 값을 표시합니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.reservation_purpose.값 예약 목적의 내부 값입니다(예: company_meeting).

    데이터 유형: 문자열
    result.reservableUnits.reservations.start 예약 시작 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)
    result.reservableUnits.reservations.state 해당 위치의 예약 상태에 대한 상세 정보입니다.

    데이터 유형: 객체

    "state": {
  "display_value": "String",
  "value": "String"
}
    result.reservableUnits.reservations.state.display_value 예약의 현재 상태에 대한 값(예: 확인됨)을 표시합니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.state.value 예약의 현재 상태에 대한 내부 값입니다(예: 2).

    데이터 유형: 문자열
    result.reservableUnits.reservations.subject 예약의 제목입니다.

    데이터 유형: 문자열
    result.reservableUnits.reservations.sys_id 필수
    예약 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]
    result.reservableUnits.reservable_quantity 연결된 예약 가능 항목을 동시에 예약할 수 있는 최대 횟수입니다. 이 값은 지역에 인접 공간을 할당할 때 사용됩니다.

    데이터 유형: 정수
    result.reservableUnits.site 예약 가능한 항목이 있는 사이트에 대한 상세 정보입니다.

    데이터 유형: 객체

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

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

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

    데이터 유형: 문자열

    테이블: 사이트 [sn_wsd_core_site]
    result.reservableUnits.standard_services
    플립 차트, 프로젝터 스크린, 화이트보드 및 마커와 같은 관련 표준 서비스입니다.

    데이터 유형: 객체 배열

    "standard_services": [
  {
    "font_awesome_icon": "String",
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.reservableUnits.standard_services.font_awesome_icon 표준 서비스와 연결된 썸네일 아이콘의 이름입니다.

    데이터 유형: 문자열
    result.reservableUnits.standard_services.name 표준 서비스와 연결된 썸네일 아이콘의 이름입니다.

    데이터 유형: 문자열
    result.reservableUnits.standard_services.short_description 표준 서비스에 대한 간략한 설명입니다.

    데이터 유형: 문자열
    result.reservableUnits.standard_services.sys_id 표준 서비스 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 표준 서비스 [sn_wsd_rsv_standard_service]
    result.reservableUnits.sys_id 예약 가능한 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 위치 [sn_wsd_core_workplace_location]
    result.reservableUnits.tableName 예약 가능한 기록이 있는 테이블의 이름입니다.

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

    데이터 유형: 문자열
    result.totalProcessed 처리된 총 기록 수입니다.

    데이터 유형: 숫자

    cURL 요청

    이 예시에서는 이 엔드포인트를 사용하여 예약 가능 항목을 검색하는 방법을 보여줍니다. 참고: 더 쉽게 읽을 수 있도록 쿼리 매개변수에 줄 바꿈이 추가되었습니다.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/reservable?
reservable_module=d9864189c3653910977396cb05013100&
start=2023-10-12T10:30:00Z&
end=2023-10-13T11:30:00Z&
include_standard_services=true&
include_reservable_purposes=true&
include_reservations_within_days=true&
include_unavailable_items=true&
near_by_location_id=undefined&
timezone=Europe/Paris&
page_size=6&
sort_by=a_z&
view=schedule&
rsv_path=browse_all&
ignore_same_day_validation=true&
schedule_view_obj={"schedule_view_date":"2023-10-12","timezone":"Europe/Paris"}&
q=building=dea39b1977220110b3d7be377b5a9955\
--request GET \
--header "Accept:application/json" 
--user "username":"password"

    반환 결과:

    {
  "result": {
    "hasMore": true,
    "reservableUnits": [
      {
        "sys_id": "fe1f744edb7650106c731dcd139619ca",
        "external_id": null,
        "email": null,
        "name": "Aspen",
        "title": "Aspen",
        "description": "A room with large windows, dark leather seats and a large wooden table.",
        "image": {
          "sys_id": "41c74902dbb650106c731dcd13961944",
          "link": "41c74902dbb650106c731dcd13961944.iix"
        },
        "number": "ROOM0000903",
        "site": {
          "sys_id": "628eec06db7650106c731dcd139619dd",
          "display_value": "North America"
        },
        "campus": {
          "sys_id": "82b2a0cedb3650106c731dcd139619e9",
          "display_value": "California Campus"
        },
        "building": {
          "sys_id": "94e264cedb3650106c731dcd13961919",
          "display_value": "CAL-B1"
        },
        "floor": {
          "sys_id": "2f554296dbba10106c731dcd139619ed",
          "display_value": "Floor 2"
        },
        "area": null,
        "capacity": "16",
        "reservable_quantity": null,
        "location_type": {
          "sys_id": "20713b83eb512010b89bfdfc9c522899",
          "display_value": "Room",
          "name": "Room"
        },
        "order": null,
        "requires_check_in": null,
        "is_reservable": "1",
        "tableName": "sn_wsd_core_room",
        "require_approval": false,
        "standard_services": [
          {
            "sys_id": "9b01458edb7650106c731dcd13961945",
            "name": "Flip chart",
            "short_description": "Flip chart with paper sheets",
            "font_awesome_icon": "fa-calendar-o"
          }
        ],
        "reservable_purposes": [
          {
            "sys_id": "18f4c3cd1ba4e01051848489cc4bcb82",
            "name": "Board room",
            "short_description": null
          }
        ],
        "is_available": true,
        "reservations": [
          {
            "sys_id": "5fe65830874bc9106342b846dabb352b",
            "number": "WRES0001001",
            "location": {
              "location": "fe1f744edb7650106c731dcd139619ca",
              "timezone": {
                "value": "US/Pacific",
                "displayValue": "US/Pacific"
              }
            },
            "configuration_item": null,
            "start": "2022-04-23T08:30:00Z",
            "end": "2022-04-23T09:30:00Z",
            "subject": null,
            "reservation_purpose": {
              "value": "meeting",
              "display_value": "Meeting"
            },
            "state": {
              "value": "confirmed",
              "display_value": "Confirmed"
            },
            "is_collided": false,
            "requested_for": {
              "sys_id": "2de07e1887cb89106342b846dabb35fe",
              "name": "Workplace User"
            }
          }
        ],
        "availableTimes": [
          [
            "2022-04-23 07:00:00",
            "2022-04-23 08:30:00"
          ],
          [
            "2022-04-23 09:30:00",
            "2022-04-23 23:00:00"
          ]
        ],
       "is_reserved": true,
       "is_selected": true,
        "includedInResult": true,
        "is_favorite": false
      }
    ],
    "reservableContainers": [],
    "nextItemIndex": -1,
    "filter": {
      "floors": [],
      "standard_services": [
        {
          "sys_id": "9b01458edb7650106c731dcd13961945",
          "name": "Flip chart",
          "short_description": "Flip chart with paper sheets",
          "font_awesome_icon": "fa-calendar-o"
        }
      ],
      "reservable_purposes": [
        {
          "sys_id": "18f4c3cd1ba4e01051848489cc4bcb82",
          "name": "Board room",
          "short_description": null
        }
      ]
    },
    "totalProcessed": 2,
    "nextFavIndex": 0
  }
}

    WSD 검색 - GET /api/sn_wsd_rsv/search/shift/{building_id}/{module_id}

    교대조 [sn_wsd_core_shift] 테이블에서 사용 가능한 교대조를 검색하는 데 사용할 수 있는 인코딩된 쿼리를 반환합니다.

    지정된 예약 가능한 모듈의 appy_to_shift 필드가 활성화된 경우에만 적용할 수 있습니다. 그렇지 않으면 반환된 인코딩된 쿼리 문자열이 비어 있습니다.

    URL 형식

    버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/search/shift/{building_id}/{module_id}

    기본 URL: /api/sn_wsd_rsv/search/shift/{building_id}/{module_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    building_id 검색 쿼리에 포함할 건물의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 건물 [sn_wsd_core_building]
    module_id 검색 쿼리에 포함할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 의자 또는 책상과 같은 유사한 유형의 직장 항목을 그룹화합니다.

    데이터 유형: 문자열

    테이블: 예약 가능한 모듈 [sn_wsd_core_reservable_module]
    표 26. 쿼리 매개변수
    이름 설명
    없음
    표 27. 요청 본문 매개변수
    이름 설명
    end_date 인코딩된 쿼리에 포함할 교대조 종료 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd hh:mm:ss
    start_date 인코딩된 쿼리에 포함할 교대조 시작 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd hh:mm:ss

    헤더

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

    표 28. 요청 헤더
    머리글 설명
    수용 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, 또 application/xml 는, text/xml.

    기본값: application/json
    표 29. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

    응답 본문 매개변수

    이름 설명
    결과 지정된 사용 가능한 교대조를 획득하는 데 사용할 인코딩된 쿼리입니다.

    데이터 유형: 객체

    "result": { 
  "moduleHasShift": Boolean,
  "query": "String"
}
    moduleHasShift 지정된 예약 가능한 모듈에 교대조가 활성화되어 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약 가능한 모듈에 교대조가 활성화되어 있습니다.
    • false: 예약 가능한 모듈에 교대조가 활성화되어 있지 않습니다. 인코딩된 쿼리가 반환되지 않았습니다.

    데이터 유형: 부울
    쿼리 지정된 예약 가능한 모듈에 대한 교대조 정보를 검색하는 데 사용할 인코딩된 쿼리입니다.

    데이터 유형: 문자열

    cURL 요청

    다음 코드 예제에서는 이 엔드포인트를 사용하여 교대조로 인코딩된 쿼리를 가져오는 방법을 보여 줍니다.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/shift/94e264cedb3650106c731dcd13961919/fc71f64fdb42a01097acc900399619a8?start_date=2022-04-23 16:00:00&end_date=2022-04-28 16:00:00"  \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

    반환 결과:

    {
  "result": { 
    "moduleHasShift" : true,
    "query" : "active=true^state=2^building=94e264cedb3650106c731dcd13961919^building.is_reservable=true^building.active=true^floorISEMPTY^ORfloor.is_reservable=true^floorISEMPTY^ORfloor.active=true^start<=2022-04-26 16:00:00^ORstartISEMPTY^end>=2022-04-28 16:00:00^ORendISEMPTY^start<=2022-04-28 16:00:00^ORstartISEMPTY^end>=2022-04-28 16:00:00^ORendISEMPTY"
  }
}

    WSD 검색 - POST /api/sn_wsd_rsv/search/availability_score

    지정된 시간대의 예약 가능한 항목에 대한 가용성 점수를 반환합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/search/availability_score

    기본 URL: /api/sn_wsd_rsv/search/availability_score

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    표 32. 쿼리 매개변수
    이름 설명
    없음
    표 33. 요청 본문 매개변수
    이름 설명
    recurringPattern 매개변수가 지정되지 않은 경우 startEndDateTimes 필요합니다. 지정된 반복 이벤트에 사용할 수 있는 예약 가능 항목을 검색하는 데 사용할 반복 패턴입니다.

    데이터 유형: 객체

    "recurringPattern": {
  "duration": Number,
  "label": "String",
  "options": {Object},
  "repeats": "String",
  "startDate": "String"
}
    recurringPattern.duration 필수 예약 가능한 항목을 사용할 수 있어야 하는 시간입니다.

    데이터 유형: 숫자

    단위: 밀리초
    recurringPattern.label 반복 패턴에 대한 설명입니다(예: 매일 5회 반복).

    데이터 유형: 문자열
    recurringPattern.options 검색할 반복 예약의 가용성 옵션입니다.

    데이터 유형: 객체

    "options": {
  "count": Number,
  "daysOfWeek": "String",
  "endDate": "String"
}
    recurringPattern.options.count 전달되지 않은 경우 endDate 필수입니다. 둘 다 전달되면 사용됩니다 count . 회의 패턴을 반복하는 횟수입니다.

    데이터 유형: 숫자
    recurringPattern.options.daysOfWeek 매개변수가 recurringPattern.repeats매주로 설정된 경우 필요합니다. 예약 가능한 요일입니다.
    유효한 값은 다음과 같습니다.
    • 1 = 월요일
    • 2 = 화요일
    • 3 = 수요일
    • 4 = 목요일
    • 5 = 금요일
    • 6 = 토요일
    • 7 = 일요일

    예를 들어 화요일, 목요일, 금요일을 지정하려면 245(구분 기호 없음)를 전달합니다. repeat is weekly이고, count 5이고, daysOfWeek 245이면 반환 결과에서 합계는 count*daysOfWeek.length(5*3=15)와 같습니다.

    데이터 유형: 문자열
    recurringPattern.options.endDate 전달되지 않은 경우 recurringPattern.options.count 필수입니다. 둘 다 전달되면 사용됩니다 count . 회의 반복의 종료 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z").

    데이터 유형: 문자열

    형식: UTC yyyy-mm-dd hh:mm:ss
    recurringPattern.repeats 필수 예약 가능한 반복 패턴입니다.
    유효한 값(대/소문자 구분):
    • 매일
    • 월별
    • 주별
    • 매년

    데이터 유형: 문자열
    recurringPattern.startDate 필수 반복 패턴의 시작 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z").

    데이터 유형: 문자열

    형식: UTC yyyy-mm-dd hh:mm:ss
    reservableId 필수 가용성 점수에 포함할 예약 가능 항목 sys_ids 목록입니다.

    데이터 유형: 배열

    테이블: 직장 위치 [sn_wsd_core_workplace_location]
    reservable유형 필수 가용성 점수에 포함할 예약 가능한 유형입니다. 검색을 구체화하는 데 사용됩니다.
    유효한 값(대/소문자 구분):
    • configuration_item
    • 위치

    데이터 유형: 문자열
    startEndDateTimes 검색할 사용자의 시간대에 있는 시작 및 종료 날짜 및 시간 목록입니다.

    데이터 유형: 객체 배열

    "startEndDateTimes": [
  {
    "end": "String",
    "start": "String"
  }
]

    기본값: 매개변수를 지정 recurringPattern 해야 합니다.
    startEndDateTimes.end 예약 가능한 종료 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd hh:mm:ss
    startEndDateTimes.start 예약 가능한 시작 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: yyyy-mm-dd hh:mm:ss

    헤더

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

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

    기본값: application/json
    콘텐츠-형식 요청 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 35. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

    응답 본문 매개변수

    이름 설명
    결과 지정된 가용성 점수에 대한 결과를 반환합니다.

    데이터 유형: 객체

    "result": {
  "reservable_sys_id": {Object}
}
    result.reservable_sys_id 가용성 점수에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservable_sys_id": {
  "available": Number,
  "score": "String",
  "total": Number
}
    result.reservable_sys_id.사용 가능 지정된 검색 기준을 충족하는 사용 가능한 예약 가능 항목 수입니다.

    데이터 유형: 숫자
    result.reservable_sys_id.점수 가용성 점수 지정된 검색 기준을 충족하는 총 예약 가능 수에서 사용 가능한 예약 가능한 수입니다. 예를 들어, 가 2이고 total 4인 경우 availablescore 값은 2/4입니다.

    데이터 유형: 문자열
    result.reservable_sys_id.total 지정된 검색 기준을 충족하는 총 예약 가능 항목 수입니다.

    데이터 유형: 숫자

    cURL 요청

    다음 코드 예제에서는 이 엔드포인트를 호출하는 방법을 보여 줍니다.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/availability_score" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
  \"reservableType\": \"location\",
  \"reservableIds\": [
    \"fe1f744edb7650106c731dcd139619ca\",
    \"5eafb44edb7650106c731dcd13961943\"
  ],
  \"recurringPattern\": {
    \"duration\": 3600000,
    \"repeats\": \"daily\",
    \"options\": {
      \"count\": 150,
      \"daysOfWeek\": \"\",
    },
    \"label\": \"Repeats daily, 5 times\",
    \"startDate\": \"2022-04-26T14:00:00Z\"
  },
  \"startEndDateTimes\": [
    {
      \"start\": \"2022-07-05 14:00:00\",
      \"end\": \"2022-07-05 15:00:00\"
    },
    {
      \"start\": \"2022-07-06 14:00:00\",
      \"end\": \"2022-07-06 15:00:00\"
    }
  ]
}" \
--user "username":"password"

    반환 결과:

    {
  "result": {
    "fe1f744edb7650106c731dcd139619ca": {
      "available": 2,
      "total": 2,
      "score": "2/2"
    },
    "5eafb44edb7650106c731dcd13961943": {
      "available": 2,
      "total": 2,
      "score": "2/2"
    }
  }