WSD 다중 예약 API
(WSD) 다중 예약 API는 워크플레이스 서비스 제공 여러 직장 위치의 예약을 관리하기 위한 엔드포인트를 제공합니다.
이 API에 액세스하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 하며 워크플레이스 안전 관리(sn_wsd_core) 및 워크플레이스 예약 관리(sn_wsd_rsv) 플러그인이 활성화되어 있어야 합니다.
이 API는 sn_wsd_rsv 네임스페이스에서 실행됩니다.
에 대한 워크플레이스 예약 관리자세한 내용은 워크플레이스 예약 관리를 참조하십시오.
WSD 다중 예약 - PATCH /api/sn_wsd_rsv/multi_reservation/cancel/{sys_id}
지정된 다중 예약을 취소합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/multi_reservation/cancel/{sys_id}
기본 URL: /api/sn_wsd_rsv/multi_reservation/cancel/{sys_id}
주:
사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| sys_id | 취소할 다중 예약의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 [sn_wsd_rsv_reservation] |
| 이름 | 설명 |
|---|---|
| 없음 |
| 이름 | 설명 |
|---|---|
| cancel_notes | 예약을 취소하는 이유입니다. 데이터 유형: 문자열 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.
| 머리글 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, 또 application/xml 는, text/xml. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 머리글 | 설명 |
|---|---|
| 안 함 |
상태 코드
이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| 결과 | 취소 요청 결과에 대한 상세 정보입니다. 데이터 유형: 객체 |
| 결과.오류 | 관련된 오류를 설명하는 메시지입니다. 데이터 유형: 문자열 |
| 결과.상위 | 상위 예약의 Sys_id입니다. 상위 항목에 하나 이상의 하위 예약이 연결되어 있을 수 있습니다. 데이터 유형: 문자열 |
| 결과.성공 | 예약이 성공적으로 취소되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.successfulReservations | 다중 예약의 성공적인 취소에 대한 상세 정보입니다. 데이터 유형: 객체 배열 |
| result.successfulReservations.msg | 취소 메시지입니다. 데이터 유형: 문자열 |
| result.successfulReservations.success | 예약이 성공적으로 취소되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.successfulReservations.sys_id | 취소된 예약의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 [sn_wsd_rsv_reservation] |
| result.unSuccessfulReservations | 다중 예약의 취소 실패에 대한 상세 정보입니다. 데이터 유형: 객체 배열 |
| result.unSuccessfulReservations.msg | 취소 메시지입니다. 데이터 유형: 문자열 |
| result.unSuccessfulReservations.success | 예약이 성공적으로 취소되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.unSuccessfulReservations.sys_id | 취소하지 않은 예약의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 [sn_wsd_rsv_reservation] |
cURL 요청
다음 코드 예제에서는 다중 예약을 취소하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/cancel/1b1fdf5987ab01506342b846dabb35ec" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{\"cancel_notes\":\"Meeting no longer needed.\"}" \
--user "username":"password’"반환 결과:
{
"result": {
"success": true,
"successfulReservations": [
{
"success": true,
"msg": "Cancelled successfully.",
"sys_id": "5b1f9f1d87ab01506342b846dabb35a4"
},
{
"success": true,
"msg": "Cancelled successfully.",
"sys_id": "931f9f1d87ab01506342b846dabb35a0"
}
],
"unSuccessfulReservations": [],
"error": null,
"parent": "1b1fdf5987ab01506342b846dabb35ec"
}
}WSD 다중 예약 - PATCH /api/sn_wsd_rsv/multi_reservation/update/{sys_id}
동일한 예약(회의)에 여러 직장 위치가 있는 다중 예약과 연결된 예약을 업데이트합니다.
이 엔드포인트는 다음과 같은 네 가지 업데이트 시나리오를 처리할 수 있습니다.
- 제목, 날짜 또는 시간과 같은 다중 예약 기록의 콘텐츠를 업데이트합니다.
- 다중 예약을 상위 항목에 기반한 단일 예약으로 변환합니다(단일 직장 위치에 대한 예약).
- 단일 예약(단일 직장 위치에 대한 예약)을 다중 예약으로 변환합니다.
- 기존 다중 예약에 직장 위치를 추가하거나 제거합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/multi_reservation/update/{sys_id}
기본 URL: /api/sn_wsd_rsv/multi_reservation/update/{sys_id}
주:
사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| sys_id | 업데이트할 예약의 Sys_id입니다.
하위 기록에서 다중 상위 예약의 상세 정보를 얻으려면 하위 기록의 source_reservation 필드에 있는 sys_id을 참조하십시오. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 없음 |
| 이름 | 설명 |
|---|---|
| 끝 | 매개변수가 shift 전달되지 않은 경우 필요합니다. 예약의 요청된 종료 시간입니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| requested_for | 예약이 이루어지는 사용자의 Sys_id 또는 이메일 주소입니다. 데이터 유형: 문자열 테이블: 사용자 [sys_user] |
| 예약 가능 항목 | 예약과 연결된 예약 가능 항목에 대한 상세 정보 목록입니다. 데이터 유형: 객체 배열 |
| reservables.is_private | 예약이 비공개인지 여부를 나타내는 플래그입니다. 비공개인 경우 예약은 소유자를 제외한 누구에게도 표시되지 않습니다. 이러한 개인 정보 설정에 대한 자세한 내용은 위치 개인 정보 보호 설정 및 영향을 참조하세요. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 기본값: 시스템 속성에서 개인정보에 대해 설정된 값입니다. |
| reservables.sys_id | 예약할 위치의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 [sn_wsd_core_workplace_location] |
| reservable_module | 필수 예약과 연결할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 예약에 필요한 직장 항목을 정의합니다. 데이터 유형: 문자열 테이블: 예약 가능한 모듈 [sn_wsd_rsv_reservable_module] |
| Shift | 예약과 연결할 교대조의 Sys_id입니다. 이 매개변수가 전달되면 매개변수가 end 필요하지 않습니다. 교대조 기반 예약에 대한 자세한 내용은 교대조 기반 예약 사용을 참조하십시오. 데이터 유형: 문자열 테이블: 교대조 [sn_wsd_core_shift] |
| 시작 | 필수 요청된 예약 시작 시간입니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| 주제 | 예약과 관련된 회의의 주제입니다. 데이터 유형: 문자열 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.
| 머리글 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, 또 application/xml 는, text/xml. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 머리글 | 설명 |
|---|---|
| 안 함 |
상태 코드
이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| 결과 | 다중 예약 생성 또는 업데이트의 결과를 반환합니다. 데이터 유형: 객체 |
| 결과.상위 | 상위 예약의 Sys_id입니다. 상위 항목에 하나 이상의 하위 예약이 연결되어 있을 수 있습니다. 데이터 유형: 문자열 |
| 결과.성공 | 예약이 성공적으로 생성되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.successfulReservations | 성공적으로 생성된 예약 목록입니다. 데이터 유형: 객체 배열 |
| result.successfulReservations.cancelled | 예약이 성공적으로 취소되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.successfulReservations.error | 예약을 생성하는 동안 문제가 발생한 경우의 오류 메시지입니다. 데이터 유형: 문자열 |
| 결과. SuccessfulReservations.insert | 예약이 성공적으로 삽입되었는지 여부를 나타내는 플래그입니다. 예: 예약이 추가되는 경우. 가능한 값:
데이터 유형: 부울 |
| result.successfulReservations.reservable | 예약이 이루어진 직장의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 [sn_wsd_core_workplace_location] |
| result.successfulReservations.success | 연결된 운영이 성공했는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.successfulReservations.sys_id | 생성된 예약의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 [sn_wsd_rsv_reservation] |
| result.successfulReservations.update | 예약이 성공적으로 업데이트되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.unSuccessfulReservations | 실패한 예약 목록입니다. 데이터 유형: 객체 배열 |
| result.unSuccessfulReservations.cancelled | 예약이 성공적으로 취소되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.unSuccessfulReservations.error | 예약을 생성하는 동안 문제가 발생한 경우의 오류 메시지입니다. 데이터 유형: 문자열 |
| result.unSuccessfulReservations.insert | 예약이 성공적으로 삽입되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.unSuccessfulReservations.reserved | 예약을 시도한 직장의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 [sn_wsd_core_workplace_location] |
| result.unSuccessfulReservations.success | 예약이 성공적으로 생성되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.unSuccessfulReservations.sys_id | 예약 실패의 Sys_id입니다. 항상 null입니다. 데이터 유형: 문자열 |
| result.unSuccessfulReservations.update | 예약이 성공적으로 업데이트되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
cURL 요청
다음 코드 예제에서는 기존 다중 예약의 콘텐츠를 수정하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"reservables\":[
{
\"sys_id\":\"fe1f744edb7650106c731dcd139619ca\"
},
{
\"sys_id\":\"02000d4edb7650106c731dcd13961914\"
}
],
\"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
\"subject\":\"Test 1\",
\"start\":\"2022-05-27 13:00:00\",
\"end\":\"2022-05-27 14:00:00\",
\"requested_for\": \"workplace_user@example.com\"
}" \
--user 'username':'password'반환 결과:
{
"result": {
"parent": "98ccb4348723cd106342b846dabb359a",
"success": true,
"successfulReservations": [
{
"success": true,
"updated": true,
"cancelled": false,
"sys_id": "6cccb4348723cd106342b846dabb359d",
"error": null,
"reservable": "5eafb44edb7650106c731dcd13961943"
},
{
"success": true,
"updated": true,
"cancelled": false,
"sys_id": "74af283c87ef8d106342b846dabb3592",
"error": null,
"reservable": "fe1f744edb7650106c731dcd139619ca"
}
],
"unSuccessfulReservations": []
}
}cURL 요청
다음 코드 예제에서는 기존 다중 예약에 직장 위치를 추가하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"reservables\":[
{
\"sys_id\":\"fe1f744edb7650106c731dcd139619ca\",
\"is_private\": false
},
{
\"sys_id\":\"5eafb44edb7650106c731dcd13961943\",
\"is_private\": false
},
{
\"sys_id\":\"c4308d4edb7650106c731dcd1396194c\",
\"is_private\": false
}
],
\"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
\"subject\":\"Test 1\",
\"start\":\"2022-05-27 13:00:00\",
\"end\":\"2022-05-27 14:00:00\",
\"requested_for\": \"workplace_user@example.com\"
}" \
--user 'username':'password'반환 결과:
{
"result": {
"parent": "98ccb4348723cd106342b846dabb359a",
"success": true,
"successfulReservations": [
{
"success": true,
"updated": true,
"cancelled": false,
"sys_id": "6cccb4348723cd106342b846dabb359d",
"error": null,
"reservable": "5eafb44edb7650106c731dcd13961943"
},
{
"success": true,
"updated": true,
"cancelled": false,
"sys_id": "74af283c87ef8d106342b846dabb3592",
"error": null,
"reservable": "fe1f744edb7650106c731dcd139619ca"
},
{
"success": true,
"inserted": true,
"sys_id": "9e6d78748723cd106342b846dabb35a5",
"error": null,
"reservable": "c4308d4edb7650106c731dcd1396194c"
}
],
"unSuccessfulReservations": []
}
}
cURL 요청
다음 코드 예제에서는 단일 예약을 다중 예약으로 변환하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"reservables\":[
{
\"sys_id\":\"fe1f744edb7650106c731dcd139619ca\",
\"is_private\": false
},
{
\"sys_id\":\"5eafb44edb7650106c731dcd13961943\",
\"is_private\": false
}
],
\"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
\"subject\":\"Test 1\",
\"start\":\"2022-05-27 13:00:00\",
\"end\":\"2022-05-27 14:00:00\",
\"requested_for\": \"workplace_user@example.com\"
}" \
--user 'username':'password'반환 결과:
{
"result": {
"success": true,
"parent": "98ccb4348723cd106342b846dabb359a",
"successfulReservations": [
{
"success": true,
"inserted": true,
"sys_id": "6cccb4348723cd106342b846dabb359d",
"error": null,
"reservable": "5eafb44edb7650106c731dcd13961943"
},
{
"success": true,
"insert": false,
"update": true,
"cancel": false,
"sys_id": "74af283c87ef8d106342b846dabb3592",
"reservable": "fe1f744edb7650106c731dcd139619ca"
}
],
"unSuccessfulReservations": [],
"error": null
}
}cURL 요청
다음 코드 예제에서는 다중 예약을 단일 예약으로 변환하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"reservables\":[
{
\"sys_id\":\"fe1f744edb7650106c731dcd139619ca\",
\"is_private\": false
}
],
\"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
\"subject\":\"Test 1\",
\"start\":\"2022-05-27 13:00:00\",
\"end\":\"2022-05-27 14:00:00\",
\"requested_for\": \"workplace_user@example.com\"
}" \
--user 'username':'password'반환 결과:
{
"result": {
"sys_id": "74af283c87ef8d106342b846dabb3592",
"success": true,
"successfulReservations": [
{
"success": true,
"insert": false,
"update": true,
"cancel": false,
"sys_id": "74af283c87ef8d106342b846dabb3592",
"reservable": "fe1f744edb7650106c731dcd139619ca",
"error": ""
},
{
"success": true,
"insert": false,
"update": true,
"cancel": true,
"sys_id": "3caf283c87ef8d106342b846dabb3596",
"reservable": "5eafb44edb7650106c731dcd13961943"
}
],
"unSuccessfulReservations": [],
"error": null
}
}WSD 다중 예약 - POST /api/sn_wsd_rsv/multi_reservation/add
여러 직장 위치에서 같은 시간에 직장 예약을 생성합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/multi_reservation/add
기본 URL: /api/sn_wsd_rsv/multi_reservation/add
주:
사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 없음 |
| 이름 | 설명 |
|---|---|
| 끝 | 매개변수가 shift 전달되지 않은 경우 필요합니다. 예약의 요청된 종료 시간입니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| requested_for | 예약이 이루어지는 사용자의 Sys_id 또는 이메일 주소입니다. 데이터 유형: 문자열 테이블: 사용자 [sys_user] |
| 예약 가능 항목 | 예약과 연결된 예약 가능 항목에 대한 상세 정보 목록입니다. 데이터 유형: 객체 배열 |
| reservables.is_private | 예약이 비공개인지 여부를 나타내는 플래그입니다. 비공개인 경우 예약은 소유자를 제외한 누구에게도 표시되지 않습니다. 이러한 개인 정보 설정에 대한 자세한 내용은 위치 개인 정보 보호 설정 및 영향을 참조하세요. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 기본값: 시스템 속성에서 개인정보에 대해 설정된 값입니다. |
| reservables.sys_id | 예약할 위치의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 [sn_wsd_core_workplace_location] |
| reservable_module | 필수 예약과 연결할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 예약에 필요한 직장 항목을 정의합니다. 데이터 유형: 문자열 테이블: 예약 가능한 모듈 [sn_wsd_rsv_reservable_module] |
| Shift | 예약과 연결할 교대조의 Sys_id입니다. 이 매개변수가 전달되면 매개변수가 end 필요하지 않습니다. 교대조 기반 예약에 대한 자세한 내용은 교대조 기반 예약 사용을 참조하십시오. 데이터 유형: 문자열 테이블: 교대조 [sn_wsd_core_shift] |
| 시작 | 필수 요청된 예약 시작 시간입니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| 주제 | 필수 예약과 관련된 회의의 주제입니다. 데이터 유형: 문자열 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.
| 머리글 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, 또 application/xml 는, text/xml. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 머리글 | 설명 |
|---|---|
| 안 함 |
상태 코드
이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| 결과 | 다중 예약 생성 또는 업데이트의 결과를 반환합니다. 데이터 유형: 객체 |
| 결과.상위 | 상위 예약의 Sys_id입니다. 상위 항목에 하나 이상의 하위 예약이 연결되어 있을 수 있습니다. 데이터 유형: 문자열 |
| 결과.성공 | 예약이 성공적으로 생성되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.successfulReservations | 성공적으로 생성된 예약 목록입니다. 데이터 유형: 객체 배열 |
| result.successfulReservations.error | 예약을 생성하는 동안 문제가 발생한 경우의 오류 메시지입니다. 데이터 유형: 문자열 |
| result.successfulReservations.inserted | 예약이 성공적으로 삽입되었는지 여부를 나타내는 플래그입니다. 예: 예약이 추가되는 경우. 가능한 값:
데이터 유형: 부울 |
| result.successfulReservations.reservable | 예약이 이루어진 직장의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 [sn_wsd_core_workplace_location] |
| result.successfulReservations.success | 예약이 성공적으로 생성되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.successfulReservations.sys_id | 생성된 예약의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 [sn_wsd_rsv_reservation] |
| result.unSuccessfulReservations | 실패한 예약 목록입니다. 데이터 유형: 객체 배열 |
| result.unSuccessfulReservations.error | 예약을 생성하는 동안 문제가 발생한 경우의 오류 메시지입니다. 데이터 유형: 문자열 |
| result.unSuccessfulReservations.inserted | 예약이 성공적으로 삽입되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.unSuccessfulReservations.reserved | 예약을 시도한 직장의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 [sn_wsd_core_workplace_location] |
| result.unSuccessfulReservations.success | 예약이 성공적으로 생성되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.unSuccessfulReservations.sys_id | 예약 실패의 Sys_id입니다. 항상 null입니다. 데이터 유형: 문자열 |
cURL 요청
이 코드 예제는 동일한 예약을 위해 두 개의 서로 다른 직장을 예약하는 방법을 보여줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/add" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"reservable_module\": \"c31241cedb7650106c731dcd13961917\",
\"subject\": \"Test-123\",
\"reservation_purpose\": \"meeting\",
\"timezone\": \"US/Pacific\",
\"requested_for\": \"6816f79cc0a8016401c5a33be04be441\",
\"reservables\": [
{
\"sys_id\": \"fe1f744edb7650106c731dcd139619ca\",
\"is_private\": false
},
{
\"sys_id\": \"d1208d4edb7650106c731dcd1396194a\",
\"is_private\": false
}
],
\"start\": \"2023-01-12T11:30:00Z\",
\"end\": \"2023-01-12T12:30:00Z\",
\"reservation_type\": \"space\"
}" \
--user "username":"password"반환 결과:
{
"result": {
"success": true,
"parent": "08e8a18687586550cfaa99b73cbb354f",
"successfulReservations": [
{
"success": true,
"inserted": true,
"sys_id": "44e8a18687586550cfaa99b73cbb3552",
"error": null,
"reservable": "fe1f744edb7650106c731dcd139619ca"
},
{
"success": true,
"inserted": true,
"sys_id": "04e8a18687586550cfaa99b73cbb3555",
"error": null,
"reservable": "d1208d4edb7650106c731dcd1396194a"
}
],
"unSuccessfulReservations": []
}
}