---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# WSD 예약 초대 대상자 API

# WSD 예약 초대 대상자 API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 21분

(WSD) 예약 초대 대상자 API는 워크플레이스 서비스 제공 예약에 초대 대상자를 추가하고, 예약의 초대 대상자를 가져오고, 예약의 초대 대상자를 재할당할 수 있는 엔드포인트를 제공합니다.
이 API에 액세스하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 하며 워크플레이스 예약 관리(sn_wsd_rsv) 플러그인이 활성화되어 있어야 합니다.

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

에 대한 워크플레이스 예약 관리자세한 내용은 [워크플레이스 예약 관리를](https://www.servicenow.com/docs/access?context=workplace-rsv-mgmt-feat&version=australia&pubname=australia-employee-service-management&ft:locale=en-US) 참조하십시오.

## WSD 예약 초대 대상자 - GET /api/sn_wsd_rsv/wsd_reservation_invitees/reservation/{sys_id} {#ariaid-title2}

지정된 예약과 연결된 초대 대상자에 대한 상세 정보를 조회합니다.
<br />

### URL 형식

버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/wsd_reservation_invitees/reservation/{sys_id}

기본 URL: /api/sn_wsd_rsv/reservation/{sys_id}  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#wsd_reserv_invite-GET-reservation__entry__2}{#wsd_reserv_invite-GET-reservation__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| sys_id | 초대 대상자 상세 정보를 반환할 예약의 Sys_id입니다. 데이터 유형: 문자열 |
[표 1. 경로 매개변수]

{#wsd_reserv_invite-GET-reservation__entry__8}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 2. 쿼리 매개변수]

{#wsd_reserv_invite-GET-reservation__entry__12}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 3. 요청 본문 매개변수]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_reserv_invite-GET-reservation__entry__16}{#wsd_reserv_invite-GET-reservation__accept-RESTAPI}

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

{#wsd_reserv_invite-GET-reservation__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_reserv_invite-GET-reservation__entry__24}{#wsd_reserv_invite-GET-reservation__entry-200-status-code}{#wsd_reserv_invite-GET-reservation__entry-401-status-code}{#wsd_reserv_invite-GET-reservation__entry-404-status-code}{#wsd_reserv_invite-GET-reservation__entry-500-status-code}

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

### 응답 본문 매개변수

{#wsd_reserv_invite-GET-reservation__entry__34}

| 이름 | 설명 |
|-|-|
| 결과 | 지정된 예약과 연결된 초대 대상자에 대한 결과를 반환합니다. 데이터 유형: 객체 { "result": { "invitees": [Array], "reservationId": "String", "reservationSubType": "String", "success": Boolean } } |
| 결과.초대 대상자 | 예약과 연결된 초대 대상자에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "invitees": [ { "email": "String", "firstName": "String", "inviteeId": "String", "inviteState": {Object}, "inviteeType": "String", "isVIP": Boolean, "isWifiRequired": Boolean, "isParkingRequired": Boolean, "lastName": "String", "licensePlate": "String", "location": {Object}, "name": "String", "org": "String", "parkingType": "String", "phoneNumber": "String", "privateNotes": "String", "reservationId": "String", "reservationInviteeId": "String", "title": "String", "visitorType": "String" } ] |
| result.invitees.email | 초대 대상자의 이메일 주소입니다. 데이터 유형: 문자열 |
| result.invitees.firstName | 초대 대상자의 이름입니다. 데이터 유형: 문자열 |
| result.invitees.inviteeId | 직원의 사용자 기록 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| result.invitees.inviteState | 예약 초대 대상자의 현재 상태에 대한 상세 정보입니다. 데이터 유형: 객체 "inviteState": { "displayValue": "String", "value": "String" } |
| result.invitees.inviteState.displayValue | 초대 대상자 상태의 값(예: 신규 또는 제거됨)을 표시합니다. 데이터 유형: 문자열 |
| result.invitees.inviteState.value | 초대 대상자 상태의 내부 값입니다. 데이터 유형: 문자열 |
| result.invitees.inviteeType | 초대 대상자 유형입니다. 유효한 값: (대/소문자 구분) * 직원 * 방문자 데이터 유형: 문자열 |
| result.invitees.isVIP | 초대 대상자가 VIP로 분류되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 초대 대상자가 VIP입니다. * false: 초대 대상자가 VIP가 아닙니다. 데이터 유형: 부울 |
| result.invitees.isWifiRequired | 입장 시 방문자에게 WIFI 암호를 제공해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: WIFI 암호를 제공합니다. * 아니오: WIFI 암호를 제공하지 않습니다. 데이터 유형: 부울 |
| result.invitees.isParkingRequired | 초대 대상자에게 주차가 필요한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 주차가 필요합니다. * false: 주차가 필요하지 않습니다. 데이터 유형: 부울 |
| result.invitees.lastName | 초대 대상자의 성입니다. 데이터 유형: 문자열 |
| result.invitees.licensePlate | 초대 대상자의 차량 번호입니다. 데이터 유형: 문자열 |
| 결과.초대 대상자.위치 | 초대 대상자의 직장 위치에 대한 상세 정보입니다. 데이터 유형: 객체 "location": { "displayName": "String", "sysId": "String" } |
| result.invitees.location.displayName | 초대 대상자의 직장 위치(예: 더블린)의 표시 이름입니다. 데이터 유형: 문자열 |
| result.invitees.location.sysId | 초대 대상자 직장 위치의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 \[sn_wsd_core_worplace_location\] |
| result.invitees.name | 초대 대상자의 이름입니다. 데이터 유형: 문자열 |
| result.invitees.org | 초대 대상자의 조직입니다. 데이터 유형: 문자열 |
| result.invitees.parkingType | 초대 대상자에게 필요한 주차 유형입니다. 유효한 값: (대/소문자 구분) * ev_parking * 없음 * normal_parking * van_accessible_parking 데이터 유형: 문자열 |
| result.invitees.phoneNumber | 초대 대상자의 전화 번호입니다. 데이터 유형: 문자열 |
| 결과.초대 대상.비공개 메모 | 초대 대상자가 제공한 추가 메모입니다. 데이터 유형: 문자열 |
| result.invitees.reservationId | 초대 대상자가 연결된 예약의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 \[sn_wsd_rsv_reservation\] |
| result.invitees.reservationInviteeId | 방문자에 대한 예약 초대 대상자 Sys_id입니다. 데이터 유형: 문자열 테이블: 예약 초대 대상자 \[sn_wsd_rsv_m2m_reservation_invitee\] |
| 결과.초대 대상자.제목 | 초대 대상자의 직함입니다. 데이터 유형: 문자열 |
| result.invitees.visitorType | 초대 대상자 유형입니다. 유효한 값: (대/소문자 구분) * 클라이언트 * 계약자 * friend_family * 기타 데이터 유형: 문자열 |
| result.reservationId | 초대 대상자가 연결된 예약의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 \[sn_wsd_rsv_reservation\] |
| result.reservationSubType | 예약 기록의 하위 유형(예: 단일 또는 다중 하위)입니다. 데이터 유형: 문자열 |
| 결과.성공 | 호출이 성공했는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 엔드포인트 호출에 성공했습니다. * false: 엔드포인트 호출에 실패했습니다. 데이터 유형: 부울 |
[ ]

### cURL 요청

다음 코드 예제에서는 예약의 초대 대상자를 검색하는 방법을 보여 줍니다.

    curl 
    "http://instance.servicenow.com/api/sn_wsd_rsv/wsd_reservation_invitees/reservation/17979dc9536b01103cf7ddeeff7b12b3" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

반환 결과:

    {
      "result": {
        "success": true,
        "reservationId": "17979dc9536b01103cf7ddeeff7b12b3",
        "reservationSubType": "single",
        "invitees": [
          {
            "reservationId": "17979dc9536b01103cf7ddeeff7b12b3",
            "location": {
              "sysId": "19efb84edb7650106c731dcd1396193c",
              "displayName": "Dublin"
            },
            "reservationInviteeId": "1f97d58d53e701103cf7ddeeff7b129a",
            "inviteeType": "employee",
            "inviteState": {
              "displayValue": "New",
              "value": "new"
            },
            "inviteeId": "6816f79cc0a8016401c5a33be04be441",
            "name": "System Administrator",
            "email": "admin@example.com"
          },
          {
            "reservationId": "17979dc9536b01103cf7ddeeff7b12b3",
            "location": {
              "sysId": "19efb84edb7650106c731dcd1396193c",
              "displayName": "Dublin"
            },
            "reservationInviteeId": "8ee7ddc9536b01103cf7ddeeff7b1219",
            "inviteeType": "employee",
            "inviteState": {
              "displayValue": "New",
              "value": "new"
            },
            "inviteeId": "62826bf03710200044e0bfc8bcbe5df1",
            "name": "Abel Tuter",
            "email": "abel.tuter@example.com"
          },
          {
            "reservationId": "17979dc9536b01103cf7ddeeff7b12b3",
            "location": {
              "sysId": "19efb84edb7650106c731dcd1396193c",
              "displayName": "Dublin"
            },
            "reservationInviteeId": "4ae7d10d536b01103cf7ddeeff7b126b",
            "inviteeType": "visitor",
            "inviteState": {
              "displayValue": "New",
              "value": "new"
            },
            "inviteeId": "86e7d10d536b01103cf7ddeeff7b1267",
            "firstName": "Visitor",
            "lastName": "User",
            "name": "Visitor User",
            "email": "visitoruser@example.com",
            "phoneNumber": "+919876543210",
            "isVIP": true,
            "parkingType": "normal_parking",
            "licensePlate": "1234",
            "isParkingRequired": true,
            "org": "Senow",
            "visitorType": "contractor",
            "title": "President",
            "isWifiRequired": true,
            "privateNotes": "Visiting"
          }
        ]
      }
    }

## WSD 예약 초대 대상자 - POST /api/sn_wsd_rsv/wsd_reservation_invitees/reassign {#ariaid-title3}

지정된 초대 대상자를 한 예약에서 다른 예약으로 재할당합니다.
<br />

### URL 형식 {#wsd_reserv_invite-POST-reassign__section_dwx_myh_wtb}

버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/wsd_reservation_invitees/reassign

기본 URL: /api/sn_wsd_rsv/wsd_reservation_invitees/reassign  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#wsd_reserv_invite-POST-reassign__entry__2}{#wsd_reserv_invite-POST-reassign__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 7. 경로 매개변수]

{#wsd_reserv_invite-POST-reassign__entry__6}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 8. 쿼리 매개변수]

{#wsd_reserv_invite-POST-reassign__entry__10}

| 이름 | 설명 |
|-|-|
| reservationId | 필수 초대 대상자를 재할당할 예약의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 \[sn_wsd_rsv_reservation\] |
| 예약 초대 대상자 | 매개변수에서 식별된 예약에 재할당할 초대 대상자 목록입니다 reservationId . 이렇게 하면 지정된 초대 대상자가 예약 초대 대상자 테이블에 따라 참석했던 이전 예약에서 제거되고 이 예약으로 이동합니다. 데이터 유형: 문자열 배열 테이블: 예약 초대 대상자 \[sn_wsd_rsv_m2m_reservation_invitee\] |
[표 9. 요청 본문 매개변수]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_reserv_invite-POST-reassign__entry__16}{#wsd_reserv_invite-POST-reassign__accept-reserv-entry}{#wsd_reserv_invite-POST-reassign__content_type-JSON-only-entry-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, 또 application/xml 는, text/xml. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 10. 요청 헤더]

{#wsd_reserv_invite-POST-reassign__entry__22}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 11. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_reserv_invite-POST-reassign__entry__26}{#wsd_reserv_invite-POST-reassign__entry-200-status-code}{#wsd_reserv_invite-POST-reassign__entry-401-status-code}{#wsd_reserv_invite-POST-reassign__entry-404-status-code}{#wsd_reserv_invite-POST-reassign__entry-500-status-code}

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

### 응답 본문 매개변수

{#wsd_reserv_invite-POST-reassign__entry__36}

| 이름 | 설명 |
|-|-|
| 결과 | 초대 대상자 재할당에 대한 상세 정보입니다. 데이터 유형: 객체 "result": { "reservationInviteeIds": [Array], "success": Boolean } |
| result.reservationInviteeIds | 지정된 예약에 재할당된 예약 초대 대상자 sys_ids 목록입니다. 데이터 유형: 문자열 배열 |
| 결과.성공 | 초대 대상자가 예약에 재할당되었는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 초대 대상자가 성공적으로 재할당되었습니다. * false: 초대 대상자가 재할당되지 않았습니다. 데이터 유형: 부울 |
[ ]

### cURL 요청

다음 코드 예제에서는 초대 대상자를 예약에 다시 할당하는 방법을 보여 줍니다.

    curl "http://instance.servicenow.com/api/sn_wsd_rsv/wsd_reservation_invitees/reassign" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
    \"reservationId\":\"3984e6c1532f01103cf7ddeeff7b129b\",
    \"reservationInvitees\":{\"aa31427f531701103cf7ddeeff7b1243\",\"e231427f531701103cf7ddeeff7b1243\"}
    }" \
    --user 'username':'password'

반환 결과:

    {
      "result": {
        "success": true,
        "reservationInviteeIds": [
          "aa31427f531701103cf7ddeeff7b1243",
          "e231427f531701103cf7ddeeff7b1243"
        ]
      }
    }

## WSD 예약 초대 대상자 - POST /api/sn_wsd_rsv/wsd_reservation_invitees/submit {#ariaid-title4}

지정된 예약에 지정된 초대 대상자를 추가합니다.
<br />

### URL 형식

버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/wsd_reservation_invitees/submit

기본 URL: /api/sn_wsd_rsv/wsd_reservation_invitees/submit  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#wsd_reserv_invite-POST-submit__entry__2}{#wsd_reserv_invite-POST-submit__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 13. 경로 매개변수]

{#wsd_reserv_invite-POST-submit__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 14. 쿼리 매개변수]

{#wsd_reserv_invite-POST-submit__entry__10}{#wsd_reserv_invite-POST-submit__invitees_email-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_firstName-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_inviteeId-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_inviteeType-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_isVIP-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_isWifiRequired-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_lastName-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_licensePlate-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_org-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_parkingType-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_phone-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_privateNotes-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_title-reserv-entry}{#wsd_reserv_invite-POST-submit__invitees_type-reserv-entry}{#wsd_reserv_invite-POST-submit__reservationId-reserv-entry}

| 이름 | 설명 |
|-|-|
| 초대 대상자 | 지정된 예약에 추가할 초대 대상자 목록입니다. 데이터 유형: 객체 "invitees": [ { "email": "String", "firstName": "String", "inviteeId": "String", "inviteeType": "String", "isVIP": Boolean, "isWifiRequired": Boolean, "lastName": "String", "licensePlate": "String", "org": "String", "parkingType": "String", "phone": "String", "privateNotes": "String", "title": "String", "visitorType": "String" } ] |
| invitees.email | "visitor"인 경우 inviteeType 필요합니다. 초대 대상자의 이메일 주소입니다. 데이터 유형: 문자열 |
| 초대 대상.firstName | 초대 대상자의 이름입니다. 데이터 유형: 문자열 |
| invitees.inviteeId | "직원"인 경우 inviteType 필요합니다. 직원의 사용자 기록 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| invitees.inviteeType | 필수 초대 대상자 유형입니다. 유효한 값: (대/소문자 구분) * 직원 * 방문자 데이터 유형: 문자열 |
| 초대 대상.isVIP | 초대 대상자가 VIP로 분류되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 초대 대상자가 VIP입니다. * false: 초대 대상자가 VIP가 아닙니다. 데이터 유형: 부울 |
| invitees.isWifiRequired | 입장 시 방문자에게 WIFI 암호를 제공해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: WIFI 암호를 제공합니다. * 아니오: WIFI 암호를 제공하지 않습니다. 데이터 유형: 부울 |
| 초대 대상자.성 | 초대 대상자의 성입니다. 데이터 유형: 문자열 |
| invitees.licensePlate | 초대 대상자의 차량 번호입니다. 데이터 유형: 문자열 |
| invitees.org | 초대 대상자의 조직입니다. 데이터 유형: 문자열 |
| 초대 대상.주차 유형 | 초대 대상자에게 필요한 주차 유형입니다. 유효한 값: (대/소문자 구분) * ev_parking * 없음 * normal_parking * van_accessible_parking 데이터 유형: 문자열 |
| 초대 대상.전화 | 초대 대상자의 전화 번호입니다. 데이터 유형: 문자열 |
| invitees.privateNotes | 초대 대상자가 제공한 추가 메모입니다. 데이터 유형: 문자열 |
| 초대 대상.제목 | 초대 대상자의 직함입니다. 데이터 유형: 문자열 |
| 초대 대상.visitorType | 초대 대상자 유형입니다. 유효한 값: (대/소문자 구분) * 클라이언트 * 계약자 * friend_family * 기타 데이터 유형: 문자열 |
| reservationId | 필수 초대 대상자를 추가할 예약의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 \[sn_wsd_rsv_reservation\] |
[표 15. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_reserv_invite-POST-submit__entry__44}{#wsd_reserv_invite-POST-submit__accept-reserv-entry}{#wsd_reserv_invite-POST-submit__content_type-JSON-only-entry-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, 또 application/xml 는, text/xml. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 16. 요청 헤더]

{#wsd_reserv_invite-POST-submit__entry__50}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 17. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_reserv_invite-POST-submit__entry__54}{#wsd_reserv_invite-POST-submit__entry-200-status-code}{#wsd_reserv_invite-POST-submit__entry-401-status-code}{#wsd_reserv_invite-POST-submit__entry-404-status-code}{#wsd_reserv_invite-POST-submit__entry-500-status-code}

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

### 응답 본문 매개변수

{#wsd_reserv_invite-POST-submit__entry__64}

| 이름 | 설명 |
|-|-|
| 결과 | 예약에 초대 대상자를 추가한 결과입니다. 데이터 유형: 객체 "result": { "reservationId": "String", "success": Boolean } |
| result.reservationId | 초대 대상자가 추가된 예약의 Sys_id입니다. 데이터 유형: 문자열 |
| 결과.성공 | 초대 대상자가 예약에 추가되었는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 초대 대상자가 성공적으로 추가되었습니다. * false: 초대 대상자가 추가되지 않았습니다. 데이터 유형: 부울 |
[ ]

### cURL 요청

다음 코드 예제에서는 방문자와 직원을 모두 예약에 추가하는 방법을 보여 줍니다.

    curl "http://instance.servicenow.com/api/sn_wsd_rsv/v1/wsd_reservation_invitees/submit" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{[
      \"reservationId\": \"041c4a13532f01103cf7ddeeff7b12c0\",
      \"invitees\": [
      {
        \"inviteeType\": \"employee\",
        \"inviteeId\": \"62826bf03710200044e0bfc8bcbe5df1\"
      },
      {
        \"inviteeType\":  \"visitor\",
        \"email\": \"visitoruser@example.com\",
        \"firstName\": \"Visitor\",
        \"lastName\":\"User\",
        \"isVIP\":true,
        \"visitorType\":\"contractor\",
        \"title\": \"ServiceNow Developer\",
        \"phone\": \"+91 9876543210\",
        \"isWifiRequired\": true,
        \"parkingType\": \"ev_parking\",
        \"licensePlate\": \"TS00TS0000\",
        \"org\": \"ServiceNow\",
        \"privateNotes\": \"Remarks\"
      }
    ]}" \
    --user 'username':'password'

반환 결과:

    {
      "result": {
        "success": true,
        "reservationId": "17979dc9536b01103cf7ddeeff7b12b3"
      }
    }