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


---

# 약속 API

# 약속 API {#ariaid-title1}

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

약속 API는 약속 예약 애플리케이션과 상호 작용하기 위한 엔드포인트를 제공합니다. 이 API를 사용하여 약속을 예약 및 일정을 조정하고, 사용 가능한 약속 슬롯을 확인하고, 약속 예약 구성 상세 정보를 가져옵니다.
이 API를 사용하기 전에 약속 예약 구성 및 서비스 구성을 설정해야 합니다. 또한 약속을 예약 중인 작업이 이미 존재해야 합니다. 자세한 내용은 [Configuring Appointment Booking](https://www.servicenow.com/docs/access?context=appointment-booking-administer&version=australia&pubname=australia-field-service-management&ft:locale=en-US) 문서를 참조하십시오.

약속 API에는 약속 예약 플러그인(com.snc.appointment_booking)이 필요하며 `sn_apptmnt_booking` 네임스페이스 내에서 제공됩니다. 이 API에 액세스하려면 snc_internal 역할이 있어야 합니다.

## 약속 - GET /sn_apptmnt_booking/약속/달력 {#ariaid-title2}

약속을 예약할 수 있는 시간 범위를 반환합니다. 반환 결과는 약속 예약 서비스 구성에 구성된 리드 타임과 향후 예약 가능한 최대 날짜를 따릅니다.
리드 타임 및 향후 예약 가능한 최대 날짜 구성에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create or modify an application configuration for Appointment Booking](https://www.servicenow.com/docs/access?context=appt-booking-create-app-config&version=australia&pubname=australia-field-service-management&ft:locale=en-US).

이 엔드포인트에 액세스하려면 snc_internal 또는 snc_external 역할이 있어야 합니다.

### URL 형식

버전이 지정된 URL: /api/sn_apptmnt_booking/{api_version}/appointment/calendar

기본 URL: /api/sn_apptmnt_booking/appointment/calendar  
주:  
사용 가능한 버전은 [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를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#appt-GET-calendar__entry__2}{#appt-GET-calendar__version-not_optional-RESTAPI}

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

{#appt-GET-calendar__entry__6}

| 이름 | 설명 |
|-|-|
| catalog_id | 필수 약속 예약 서비스 구성으로 구성된 기록 생성자의 Sys_id입니다. 테이블: 기록 생성자 \[sc_cat_item_producer\] 데이터 유형: 문자열 |
| 위치 | 필수 약속 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| opened_for | 필수 약속이 예약되는 사용자의 Sys_id입니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
[표 2. 쿼리 매개변수]

{#appt-GET-calendar__entry__14}

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

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 4. 요청 헤더]

{#appt-GET-calendar__entry__22}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

### 응답 본문 매개변수

{#appt-GET-calendar__entry__34}

| 이름 | 설명 |
|-|-|
| 결과 | 엔드포인트 요청의 결과에 대한 정보입니다. 데이터 유형: 객체 "result": { "range_end": "String", "range_start": "String" } |
| result.range_end | 약속을 예약할 수 있는 범위의 끝입니다. `범위 종료 = 오늘 + 향후 예약 가능한 최대 일` 데이터 유형: 문자열 형식: 내부 날짜 시간 형식의 약속 시간대입니다. |
| result.range_start | 약속을 예약할 수 있는 범위의 시작입니다. `범위 시작 = 오늘 + 리드 타임` 데이터 유형: 문자열 형식: 내부 날짜 시간 형식의 약속 시간대입니다. |
[ ]

### cURL 요청

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

    curl "http://instance.servicenow.com/api/sn_apptmnt_booking/v1/appointment/calendar?catalog_id=e4c1116b3b810300ce8a4d72f3efc40f&location=32e8499cdb2d2200d75270f5bf9619d6&opened_for=6816f79cc0a8016401c5a33be04be441" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

결과:

    {
      "result": {
        "range_start": "2023-02-08 03:52:27",
        "range_end": "2023-02-21 23:52:27"
      }
    }

## 약속 - GET /sn_apptmnt_booking/appointment/configuration {#ariaid-title3}

지정된 약속 예약 서비스 구성에 정의된 구성을 반환합니다.
또한 약속 예약 위젯에서 슬롯을 렌더링하는 데 필요한 번역과 사용자 날짜 및 시간 기본 설정을 반환합니다.

이 엔드포인트에 액세스하려면 snc_internal 또는 snc_external 역할이 있어야 합니다.

### URL 형식

버전이 지정된 URL: /api/sn_apptmnt_booking/{api_version}/appointment/configuration

기본 URL: /api/sn_apptmnt_booking/appointment/configuration  
주:  
사용 가능한 버전은 [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를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#appt-GET-configuration__entry__2}{#appt-GET-configuration__version-not_optional-RESTAPI}

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

{#appt-GET-configuration__entry__6}

| 이름 | 설명 |
|-|-|
| catalog_id | 필수 약속 예약 서비스 구성으로 구성된 기록 생성자의 Sys_id입니다. 데이터 유형: 문자열 테이블: 기록 생성자 \[sc_cat_item_producer\] |
[표 8. 쿼리 매개변수]

{#appt-GET-configuration__entry__10}

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

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 10. 요청 헤더]

{#appt-GET-configuration__entry__18}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 12. 상태 코드]

### 응답 본문 매개변수

{#appt-GET-configuration__entry__30}

| 이름 | 설명 |
|-|-|
| 결과 | 엔드포인트 요청의 결과입니다. 데이터 유형: 객체 "result": { "active": Boolean, "active_string": "String", "advanced_calendar_view_portal": Boolean, "auto_acceptance": Boolean, "locale_language": "String", "service_config": {Object}, "task_table": "String", "translations": {Object}, "userDateFormatOptions": {Object}, "useRR": Boolean, "userTimeFormat": {Object}, "userTimeFormatOptions": {Object}, "view_scale": "String" } |
| 결과.활성 | 연결된 카탈로그 ID에 대한 서비스 구성 설정이 활성 상태인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 카탈로그 ID에 대한 서비스 구성 설정이 활성 상태입니다. * false: 카탈로그 ID에 대한 서비스 구성 설정이 활성화되어 있지 않습니다. 데이터 유형: 부울 |
| result.active_string | 연결된 카탈로그 ID에 대한 서비스 구성 설정 상태의 텍스트 표현입니다. 데이터 유형: 문자열 |
| result.advanced_calendar_view_portal | 고급 달력 뷰가 포털에 표시되는지 아니면 기본 뷰를 표시하는지 여부를 나타내는 플래그입니다. 고급 달력 보기에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create or modify an application configuration for Appointment Booking](https://www.servicenow.com/docs/access?context=appt-booking-create-app-config&version=australia&pubname=australia-field-service-management&ft:locale=en-US). 가능한 값: * true: 고급 달력 뷰가 포털에 표시됩니다. * false: 기본 뷰가 포털에 표시됩니다. 데이터 유형: 부울 |
| result.auto_acceptance | 약속이 자동으로 수락됨 상태로 전환되는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 약속이 자동으로 수락됨 상태로 전환됩니다. * false: 에이전트가 약속을 수동으로 수락해야 합니다. 데이터 유형: 부울 |
| result.locale_language | 사용자의 언어 설정입니다. 데이터 유형: 문자열 형식: ISO 639.1 언어 코드 |
| result.service_config | 서비스 구성에 대한 상세 정보입니다. 데이터 유형: 객체 "service_config": { "active": Boolean, "active_string": "String", "appointment_booking_config": "String", "appointment_duration": "String", "appointments_per_bookable_slot": "String", "bookable_days": "String", "cancel_by_time": "String", "default_timezone": "String", "enable_advanced_config": Boolean, "field_mapping": {Object}, "future_bookable_max_days": "String", "lead_time": "String", "mandatory": "String", "use_slot_end_time_as": "String", "work_duration": "String" } |
| result.service_config.active | 약속 예약 서비스 구성의 활성 상태를 나타내는 플래그입니다. 가능한 값: * true: 활성 * false: 비활성 데이터 유형: 부울 |
| result.service_config.active_string | 약속 예약 서비스 구성의 상태를 나타내는 텍스트입니다. 데이터 유형: 문자열 |
| result.service_config.appointment_booking_config | 연결된 카탈로그 ID에 대한 약속 예약 서비스 구성 설정의 Sys_id입니다. 데이터 유형: 문자열 테이블: 약속 예약 서비스 구성 \[sn_apptmnt_booking_service_config\] |
| result.service_config.appointment_duration | 약속의 길이입니다. 데이터 유형: 문자열 단위: 분 |
| result.service_config.appointments_per_bookable_slot | 연결된 슬롯에 대해 예약할 수 있는 약속 수입니다. 데이터 유형: 문자열 |
| result.service_config.bookable_days | 약속을 예약할 수 있는 일을 나타내는 쉼표로 구분된 값입니다. 일은 월요일 = 1, 일요일 = 7인 정수로 표시됩니다. 데이터 유형: 문자열 |
| result.service_config.cancel_by_time | 약속이 시작되기 전 사용자가 약속을 취소할 수 있는 최소 시간입니다. 예를 들어, 오후 1:00로 예약된 약속이 있고 시간별로 2시간 취소가 있는 경우 늦어도 오전 10:59까지 약속을 취소해야 합니다. 형식: 이 값은 "1970-01-01 00:00:00"의 날짜 및 시간 차이입니다. 따라서 반환된 값이 "1970-01-01 04:00:00"이면 회의가 시작되기 4시간 전에 회의실을 취소해야 합니다. 데이터 유형: 문자열 |
| result.service_config.default_timezone | 약속이 예약되는 시간대 구성입니다. 가능한 값: * 위치: 약속 위치의 시간대를 사용합니다. * 사용자: 약속을 예약 중인 사람의 시간대를 사용합니다. 데이터 유형: 문자열 |
| result.service_config.enable_advanced_config | 약속을 예약할 때 약속 예약 구성과 약속 예약 규칙을 고려하는지 여부를 나타내는 플래그입니다. 자세한 내용은 [Create appointment booking advanced configuration](https://www.servicenow.com/docs/access?context=appintment-booking-day-level-config&version=australia&pubname=australia-field-service-management&ft:locale=en-US) 문서를 참조하십시오. 가능한 값: * true: 약속을 예약할 때 약속 예약 구성과 약속 예약 규칙이 고려됩니다. * false: 약속을 예약할 때 약속 예약 구성 및 약속 예약 규칙이 고려되지 않습니다. 데이터 유형: 부울 |
| result.service_config.field_mapping | 약속을 예약하는 데 사용된 위치와 연락처 값에 매핑된 카탈로그 변수에 대한 상세 정보입니다. 데이터 유형: 객체 "field_mapping": { "contact": "String", "contactRPVariable": {Object}, "location": "String", "locationRPVariable": {Object} } |
| result.service_config.field_mapping.문의 | 연락처 값을 포함하는 카탈로그 변수의 이름입니다. 데이터 유형: 문자열 |
| result.service_config.field_mapping 입니다.contactRPVariable | 위치 카탈로그 변수 데이터에 대한 상세 정보입니다. 데이터 유형: 객체 "contactRPVariable": { "displayName": "String", "label": "String", "name": "String" } |
| result.service_config.field_mapping 입니다.contactRPVariable.displayName | 연락처 카탈로그 변수의 표시 이름입니다. 데이터 유형: 문자열 |
| result.service_config.field_mapping 입니다.contactRPVariable.label | 연락처 카탈로그 변수의 레이블입니다. 데이터 유형: 문자열 |
| result.service_config.field_mapping 입니다.contactRPVariable.name | 연락처 카탈로그 변수의 이름입니다. 데이터 유형: 문자열 |
| result.service_config.field_mapping.위치 | 위치 값을 포함하는 카탈로그 변수의 이름입니다. 데이터 유형: 문자열 |
| result.service_config.field_mapping 입니다.위치RPVariable | 위치 카탈로그 변수 데이터에 대한 상세 정보입니다. 데이터 유형: 객체 "locationRPVariable": { "displayName": "String", "label": "String", "name": "String" } |
| result.service_config.field_mapping 입니다.locationRPVariable.displayName | 위치 카탈로그 변수의 표시 이름입니다. 데이터 유형: 문자열 |
| result.service_config.field_mapping 입니다.locationRPVariable.label | 위치 카탈로그 변수의 레이블입니다. 데이터 유형: 문자열 |
| result.service_config.field_mapping 입니다.locationRPVariable.name | 위치 카탈로그 변수의 이름입니다. 데이터 유형: 문자열 |
| result.service_config. future_bookable_max_days | 약속을 예약할 수 있는 향후 최대 일수입니다. 데이터 유형: 문자열 |
| result.service_config.lead_time | 약속이 시작되기 전 사용자가 약속을 예약할 수 있는 최소 시간입니다. 예를 들어, 오후 1:00에 약속을 예약하려고 하고 리드 타임이 2시간인 경우 늦어도 오전 10:59까지 약속을 예약해야 합니다. 형식: 이 값은 "1970-01-01 00:00:00"의 날짜 및 시간 차이입니다. 따라서 반환된 값이 "1970-01-01 04:00:00"이면 회의실을 4시간 전에 예약해야 합니다. 데이터 유형: 문자열 |
| result.service_config.필수 | 약속이 필수인지 여부를 나타내는 표시기입니다. 가능한 값: * 0: 예약은 필수가 아닙니다. * 1: 예약은 필수입니다. 데이터 유형: 문자열 |
| result.service_config.use_slot_end_time_as | 에이전트가 도착하거나 연결된 약속에 예약된 작업을 완료하는 시간을 나타내는 표시기입니다. 가능한 값: * arrive_by: 에이전트가 지정된 시간 슬롯 내에 약속 위치에 도착합니다. * complete_by: 에이전트가 지정된 시간 슬롯 내에 약속에 대한 작업을 완료합니다. * empty: completed_by와 동일합니다. 데이터 유형: 문자열 |
| result.service_config.work_duration | 약속을 수행하는 데 걸리는 시간입니다. 작업 기간은 약속 예약 서비스 구성에서 구성됩니다. 자세한 내용은 [Create or modify service configuration for Appointment Booking](https://www.servicenow.com/docs/access?context=appt-booking-create-service-config&version=australia&pubname=australia-field-service-management&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 문자열 단위: 분 |
| result.task_table | 약속을 예약할 수 있는 테이블의 이름입니다. 약속 예약 서비스 구성에서 구성됩니다. 데이터 유형: 문자열 |
| 결과.번역 | 약속 예약 위젯에 사용되는 텍스트 번역의 이름-값 쌍입니다. 작업, 메시지, 일, 월에 대해 번역된 값을 포함합니다. 데이터 유형: 객체 |
| result.userDateFormatOptions | JS 날짜 객체를 렌더링하는 데 필요한 날짜 형식 옵션에 대해 설명합니다. 이 값은 수정할 수 없는 약속 예약 상수에서 설정됩니다. 데이터 유형: 객체 "userDateFormatOptions": { "day": "String", "month": "String", "week": "String", "weekday": "String" } |
| result.userDateFormatOptions.day | 일 날짜 형식입니다. 데이터 유형: 문자열 형식: 숫자(값 또는 1-31) |
| result.userDateFormatOptions.month | 월 날짜 형식입니다. 데이터 유형: 문자열 형식: 짧음(1월, 2월, 3월 등의 값) |
| result.userDateFormatOptions.week | 주 날짜 형식입니다. 데이터 유형: 문자열 형식: 숫자(1-5 값) |
| result.userDateFormatOptions.weekday | 평일 날짜 형식입니다. 데이터 유형: 문자열 형식: 짧음(월, 화, 수 등의 값) |
| 결과.useRR | sn_apptmnt_booking.use_read_replica_from_ui 속성의 값입니다. 이 값은 UI에서 쿼리가 수행될 때 읽기 전용 복제본 데이터베이스를 사용하여 약속 슬롯을 가져올지 여부를 정의합니다. 가능한 값: * true: 읽기 전용 복제본 데이터베이스를 사용하여 슬롯을 가져옵니다. * false: 읽기 전용 복제본 데이터베이스를 사용하여 슬롯을 가져오지 않습니다. 데이터 유형: 부울 |
| result.userTimeFormat | 사용자의 시간 형식을 설명합니다. 사용자는 엔드포인트를 요청하는 사람입니다. 플랫폼을 통해 만든 경우 에이전트입니다. 포털을 통해 생성한 경우 고객입니다. 데이터 유형: 객체 "userTimeFormat": { "type": "String", "value": "String" } |
| result.userTimeFormat.type | 시간 형식의 유형입니다. 가능한 값: * 12hr * 24hr 데이터 유형: 문자열 |
| result.userTimeFormat.value | "HH:mm:ss"와 같은 기본 시간 형식입니다. 데이터 유형: 문자열 |
| result.userTimeFormatOptions | JS 시간 객체를 렌더링하는 데 필요한 시간 형식 옵션에 대해 설명합니다. 이 값은 수정할 수 없는 약속 예약 상수에서 설정됩니다. 데이터 유형: 객체 "userTimeFormatOptions": { "hour": "String", "hourCycle": "String", "minute": "String" } |
| result.userTimeFormatOptions.hour | 시간 형식입니다. 형식: 숫자(값 1-12) |
| result.userTimeFormatOptions.hourCycle | 시간 주기에 대한 형식입니다. 가능한 값은 h23뿐입니다. |
| result.userTimeFormatOptions.minute | 분 형식입니다. 형식: 숫자(1-60 값) |
| result.view_scale | 서비스 구성에서 구성된 뷰입니다. 가능한 값: * 일 * 주 데이터 유형: 문자열 |
[ ]

### cURL 요청

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

    curl "http://instance.servicenow.com/api/sn_apptmnt_booking/v1/appointment/configuration?catalog_id=e4c1116b3b810300ce8a4d72f3efc40f" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

응답:

    {
      "result": {
        "active": true,
        "activeString": "true"
        "view_scale": "day",
        "auto_acceptance": true,
        "task_table": "wm_order",
        "advanced_calendar_view_portal": false,
        "service_config": {
          "appointment_booking_config": "deb1d2fd3b033200ce8a4d72f3efc4c2",
          "future_bookable_max_days": "14",
          "appointments_per_bookable_slot": "20",
          "bookable_days": "1,2,3,4,5",
          "active": true,
          "activeString": "true",
          "mandatory": "1",
          "lead_time": "1970-01-01 04:00:00",
          "cancel_by_time": "1970-01-01 04:00:00",
          "appointment_duration": "120",
          "default_timezone": "location",
          "work_duration": "60",
          "enable_advanced_config": true,
          "field_mapping": {
            "location": "location"
            "opened_for": "contact",
            "locationRPVariable": {
              "name": "location",
              "label": "Location",
              "displayName": "location"
            },
            "contactRPVariable": {
              "name": "contact",
              "label": "Contact",
              "displayName": "contact"
            }
          },
          "use_slot_end_time_as": ""
        },
        "translations": {
          "submit_btn_text": "Select",
          "cancel_btn_text": "Cancel",
          "calendar_prev_text": "Previous",
          "select_appointment_calendar_text": "Select Appointment Calendar",
          "calendar_next_text": "Next",
          "previous_btn_text": "Previous day",
          "next_btn_text": "Next day",
          "date_input_placeholder_text": "Pick a date",
          "show_calendar_btn_text": "Show Calendar",
          "app_window_btn_text_start_time": "Start time",
          "app_window_btn_text_end_time": "End time",
          "appointment_window_aria_label_start_text": "Available appointment window ",
          "no_appointment": "No appointments",
          "time_zone": "Time zone",
          "selected_window": "The window which has been selected is ",
          "day_names": {
            "1": "Monday",
            "2": "Tuesday",
            "3": "Wednesday",
            "4": "Thursday",
            "5": "Friday",
            "6": "Saturday",
            "7": "Sunday"
          },
          "days": [
            "Sunday",
            "Monday",
            "Tuesday",
            "Wednesday",
            "Thursday",
            "Friday",
            "Saturday"
          ],
          "daysShort": [
            "Sun",
            "Mon",
            "Tue",
            "Wed",
            "Thu",
            "Fri",
            "Sat"
          ],
          "daysMin": [
            "Su",
            "Mo",
            "Tu",
            "We",
            "Th",
            "Fr",
            "Sa"
          ],
          "months": [
            "January",
            "February",
            "March",
            "April",
            "May",
            "June",
            "July",
            "August",
            "September",
            "October",
            "November",
            "December"
          ],
          "monthsShort": [
            "Jan",
            "Feb",
            "Mar",
            "Apr",
            "May",
            "Jun",
            "Jul",
            "Aug",
            "Sep",
            "Oct",
            "Nov",
            "Dec"
          ],
          "today": "Today",
          "clear": "Clear",
          "language": "en",
          "arrive_by_msg": "The agent will arrive within the selected slot."
        },
        "useRR": true,
        "locale_language": "en",
        "userTimeFormat": {
          "value": "HH:mm:ss",
          "type": "24hr"
        },
        "userDateFormatOptions": {
          "weekday": "short",
          "year": "numeric",
          "month": "short",
          "day": "numeric"
        },
        "userTimeFormatOptions": {
          "hour": "numeric",
          "minute": "numeric",
          "hourCycle": "h23"
        }
      }
    }

## 약속 - GET /sn_apptmnt_booking/약속/execute_rule_conditions {#ariaid-title4}

지정된 작업 sys_id 또는 지정된 카탈로그 항목 데이터 집합과 일치하는 약속 예약 서비스 구성 규칙의 sys_id 반환합니다.
전달된 작업 ID 또는 카탈로그 항목 데이터는 서비스 구성에 대해 정의된 규칙에 따라 평가됩니다. 이러한 조건이 일치하는 첫 번째 규칙의 sys_id이 반환됩니다. 그런 다음 이 규칙을 후속 가용성 요청에 sys_id 전달하여 규칙에 정의된 올바른 슬롯을 가져와야 합니다.

이 엔드포인트에 액세스하려면 snc_internal 또는 snc_external 역할이 있어야 합니다.

### URL 형식 {#appt-GET-exec_rule_conditions__section_uzx_w3p_mwb}

버전이 지정된 URL: /api/sn_apptmnt_booking/{api_version}/appointment/execute_rule_conditions

기본 URL: /api/sn_apptmnt_booking/appointment/execute_rule_conditions  
주:  
사용 가능한 버전은 [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를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#appt-GET-exec_rule_conditions__entry__2}{#appt-GET-exec_rule_conditions__version-not_optional-RESTAPI}

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

{#appt-GET-exec_rule_conditions__entry__6}

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

{#appt-GET-exec_rule_conditions__entry__10}

| 이름 | 설명 |
|-|-|
| 카탈로그Id | 필수 약속 예약 서비스 구성으로 구성된 기록 생성자의 Sys_id입니다. 데이터 유형: 문자열 테이블: 기록 생성자 \[sc_cat_item_producer\] |
| otherInputs | 매개변수가 taskId 지정되지 않은 경우 필요합니다. 서비스 구성에 대해 정의된 규칙과 비교할 카탈로그 항목 변수의 이름-값 쌍입니다. 예: "otherInputs": { "u_sn_point_of_sale_variable_set": "true", "short_description": "Point-of-Sale Installation", "contact": "6816f79cc0a8016401c5a33be04be441", "description": "Install new point-of-sale system with cash tray", "location": "32e8499cdb2d2200d75270f5bf9619d6" } 데이터 유형: 객체 |
| taskId | 매개변수가 otherInputs 지정되지 않은 경우 필요합니다. 약속이 예약되는 작업 기록의 Sys_id입니다. 약속이 예약되는 작업 테이블에 있습니다. 는 catalogId 특정 약속 예약 구성에 해당하며 모든 구성에는 약속이 예약되는 작업 테이블이 있습니다. 데이터 유형: 문자열 |
[표 15. 요청 본문 매개변수]

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 16. 요청 헤더]

{#appt-GET-exec_rule_conditions__entry__24}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 18. 상태 코드]

### 응답 본문 매개변수

{#appt-GET-exec_rule_conditions__entry__36}

| 이름 | 설명 |
|-|-|
| 결과 | 엔드포인트에서 반환하는 정보에 대한 설명입니다. 데이터 유형: 객체 "result": { "dedicatedCapacity": Boolean, "futureMaxBookableDays": "String", "ruleId": "String", "ruleName": "String" } |
| 결과.전용 용량 | 연결된 규칙에 전용 용량이 있는지 여부를 나타내는 플래그입니다. 전용 용량에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create service configuration rules for a service configuration](https://www.servicenow.com/docs/access?context=create-appt-booking-service-config-rules&version=australia&pubname=australia-field-service-management&ft:locale=en-US). 가능한 값: * true: 규칙에 전용 용량이 있습니다. * false: 연결된 규칙과 기본 구성 간에 용량이 공유됩니다. 또한 전용 용량이 없는 다른 규칙과도 공유됩니다. 데이터 유형: 부울 |
| 결과.미래최대 예약 가능 날짜 | 일치 규칙이 적용된 약속을 예약할 수 있을 때까지 남은 최대 일 수입니다. 데이터 유형: 문자열 |
| result.ruleId | 요청에 전달된 OR otherInputs 매개변수와 일치하는 약속 예약 서비스 구성 규칙의 taskId Sys_id입니다. 데이터 유형: 문자열 테이블: 서비스 구성 규칙 \[sn_apptmnt_booking_config_rule\] |
| result.ruleName | 전달된 매개변수와 일치하는 규칙의 이름입니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

다음 코드 예제에서는 매개변수를 taskId 사용하여 규칙 비교를 요청하는 방법을 보여줍니다.

    curl "http://instance.servicenow.com/api/sn_apptmnt_booking/v1/appointment/execute_rule_conditions" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"catalogId\": \"e4c1116b3b810300ce8a4d72f3efc40f\",
      \"taskId\": \"ce1f397c43b861105e0dbcba6ab8f298\"}" \
    --user 'username':'password'

응답:

    {
      "result": {
        "ruleId": "f7d5d98f437c21105e0dbcba6ab8f2fc",
        "ruleName": "Priority 1 rule",
        "dedicatedCapacity": true,
        "futureMaxBookableDays": "14"
      }
    }

### cURL 요청 {#appt-GET-exec_rule_conditions__example_gcb_j1w_mwb}

다음 코드 예제에서는 매개변수를 otherInputs 사용하여 규칙 비교를 요청하는 방법을 보여줍니다.

    curl "http://instance.servicenow.com/api/sn_apptmnt_booking/v1/appointment/execute_rule_conditions" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"catalogId\": \"e4c1116b3b810300ce8a4d72f3efc40f\",
      \"otherInputs\": {
        \"u_sn_point_of_sale_variable_set\": \"true\",
        \"short_description\": \"Point-of-Sale Installation\",
        \"contact\": \"6816f79cc0a8016401c5a33be04be441\",
        \"description\": \"Install new point-of-sale system with cash tray\",
        \"location\": \"32e8499cdb2d2200d75270f5bf9619d6\"
      }
    }" \
    --user 'username':'password'

응답:

    {
      "result": {
        "ruleId": " 1d1bb72b4334a1105e0dbcba6ab8f275",
        "ruleName": "Lake View SC rule",
        "dedicatedCapacity": false,
        "futureMaxBookableDays": "21"
      }
    }

## 약속 - POST /sn_apptmnt_booking/appointment/appointment {#ariaid-title5}

작업에 대한 약속을 현장 서비스 관리 예약하고 일정을 조정할 수 있습니다.
주:  
이 엔드포인트를 사용하면 관련 약속 예약 서비스 구성에 시작 및 종료 시간이 정의되어 있고 사용 가능한 슬롯이 있는 약속만 예약하고 예약할 수 있습니다.

작업에 대한 현장 서비스 관리 자세한 내용은 다음 문서를 참조하십시오 [Configuring Appointment Booking](https://www.servicenow.com/docs/access?context=appointment-booking-administer&version=australia&pubname=australia-field-service-management&ft:locale=en-US).

### URL 형식

버전이 지정된 URL: /api/sn_apptmnt_booking/{api_version}/appointment/appointment

기본 URL: /api/sn_apptmnt_booking/appointment/appointment  
주:  
사용 가능한 버전은 [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를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#appt-POST-appointment__entry__2}{#appt-POST-appointment__version-not_optional-RESTAPI}

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

{#appt-POST-appointment__entry__6}

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

{#appt-POST-appointment__entry__10}

| 이름 | 설명 |
|-|-|
| actualEndDate | 필수 약속 시간대의 약속 슬롯에 대한 종료 날짜 및 시간입니다. 날짜 유형: 문자열 형식: YYYY-MM-dd HH:mm:ss |
| 실제 시작 날짜 | 필수 약속 시간대의 약속 슬롯에 대한 시작 날짜 및 시간입니다. 날짜 유형: 문자열 형식: YYYY-MM-dd HH:mm:ss |
| 카탈로그Id | 약속 예약 서비스 구성에 대해 구성된 기록 생성자의 Sys_id입니다. 이 매개변수를 전달하지 않으면 엔드포인트는 and taskTable 매개변수에서 taskId 이 정보를 식별하려고 시도합니다. 그렇지 않으면 엔드포인트가 실패하고 오류가 반환됩니다. 날짜 유형: 문자열 테이블: 약속 예약 서비스 구성 \[sn_apptmnt_booking_service_config\] 테이블의 카탈로그 항목 필드입니다. |
| 종료 날짜UTC | 필수 약속 슬롯의 종료 날짜 및 시간(UTC 시간대)입니다. 날짜 유형: 문자열 형식: YYYY-MM-dd HH:mm:ss |
| 위치 | 필수 약속과 관련된 위치 기록의 Sys_id입니다. 날짜 유형: 문자열 테이블: 위치 \[cmn_location\] |
| openedFor | 필수 약속을 예약 중인 사용자의 Sys_id입니다. 날짜 유형: 문자열 테이블: 사용자 \[sys_user\] |
| reschedule | 필수 약속 일정이 조정되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 약속이 현재 존재하며 일정을 조정 중입니다. * false: 새 약속. 데이터 유형: 부울 |
| service_cofig_rule | 규칙에 따라 약속이 예약되는 경우 서비스 구성 규칙의 sys_id입니다. 날짜 유형: 문자열 테이블: 서비스 구성 규칙 \[sn_apptmnt_booking_config_rule\] |
| startDateUTC | 필수 약속 슬롯의 시작 날짜 및 시간(UTC 시간대)입니다. 날짜 유형: 문자열 형식: YYYY-MM-dd HH:mm:ss |
| taskId | 필수 약속이 예약되는 작업 기록의 Sys_id입니다. 날짜 유형: 문자열 테이블: 매개변수에 taskTable 정의됩니다. |
| taskTable | 필수 약속이 예약되는 작업 기록이 포함된 테이블의 이름입니다. 날짜 유형: 문자열 |
| 시간대 | 필수 지정된 약속 슬롯을 예약하거나 업데이트할 때 사용할 시간대입니다. 형식: 미국/동부와 같은 국가/도시 또는 지역 형식 날짜 유형: 문자열 |
| validate_request | 약속 요청을 확인할지 여부를 나타내는 플래그입니다. 확인에 실패하는 경우 엔드포인트가 실패하고 문제를 설명하는 오류 메시지를 반환합니다. 다음 유효성 검사가 수행됩니다. * 카탈로그 ID 확인: 전달된 catalogId 매개변수가 유효한 sys_id인지 확인합니다. * 시간대 확인: 전달된 timezone 매개변수가 유효한 시간대인지 확인합니다. * 작업 ID 확인: 전달된 taskId 매개변수가 유효한 sys_id이고 작업이 보류 중인 디스패치 상태인지 확인합니다. * 중복 슬롯 확인: 일정 변경의 경우 원래 약속과 동일한 슬롯을 통과하면 슬롯이 기술적으로 이미 예약되어 있으므로 슬롯이 잘못됩니다. * 슬롯 확인: 전달된 슬롯 정보가 구성된 정보와 일치하는지, 슬롯의 시간 범위가 동일한지 확인합니다. 예를 들어 구성에서 2시간 슬롯이 구성되어 있지만 3시간 슬롯을 전달하면 슬롯이 유효하지 않습니다. 마찬가지로 오전 9:00부터 오전 11:00까지의 슬롯을 사용할 수 있지만 통과된 슬롯이 오전 9:30부터 오전 11:30까지인 경우 통과된 슬롯은 유효하지 않습니다. 유효한 값은 다음과 같습니다. * true: 약속 정보를 확인합니다. * false: 약속 정보를 확인하지 않습니다. 데이터 유형: 부울 기본값: false |
[표 21. 요청 본문 매개변수]

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 22. 요청 헤더]

{#appt-POST-appointment__entry__44}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 24. 상태 코드]

### 응답 본문 매개변수

{#appt-POST-appointment__entry__54}

| 이름 | 설명 |
|-|-|
| 결과 | 엔드포인트 요청의 결과에 대한 정보입니다. 데이터 유형: 객체 "result": { "data": "String", "message": "String", "reason": "String", "success": Boolean } |
| 결과.데이터 | 생성되거나 일정이 조정된 약속 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| 결과.메시지 | 약속 요청이 예약되었는지 또는 실패했는지 여부를 설명하는 메시지입니다. 예를 들어 오류 응답에는 다음이 포함될 수 있습니다. * 약속을 예약할 수 없습니다. * 약속 일정을 조정할 수 없습니다. 작업이 성공하면 다음과 유사한 메시지가 반환됩니다. 약속이 성공적으로 예약되었습니다. 데이터 유형: 문자열 |
| 결과.이유 | 약속 요청의 결과에 대한 추가 정보입니다. 데이터 유형: 문자열 |
| 결과.성공 | 요청의 성공 여부를 나타내는 플래그입니다. 가능한 값: * true: 요청 성공 * false: 요청 실패 데이터 유형: 부울 |
[ ]

### cURL 요청

다음 예는 작업 주문 \[wm_order\] 테이블의 작업에 대한 새 약속 예약을 만드는 방법을 보여줍니다.

    curl "https://instance.servicenow.com/api/sn_apptmnt_booking/appointment/appointment" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
    \"startDateUTC\": \"2023-02-01 20:00:00\",
    \"endDateUTC\": \"2023-02-01 22:00:00\",
    \"actualStartDate\": \"2023-02-01 15:00:00\",
    \"actualEndDate\": \"2023-02-01 17:00:00\",
    \"taskTable\": \"wm_order\",
    \"location\": \"32e8499cdb2d2200d75270f5bf9619d6\",
    \"catalogId\": \"e4c1116b3b810300ce8a4d72f3efc40f\",
    \"openedFor\": \"ddce70866f9331003b3c498f5d3ee417\"
    \"taskId\": \"ce1f397c43b861105e0dbcba6ab8f298\",
    \"reschedule\": false,
    \"service_configuration_rule\": \"\",
    \"timezone\": \"US/Eastern\"
    }" \

    --user 'username':'password'

응답:

    {
    "result": {
      "success": true,
      "message": "Your appointment has been scheduled successfully.",
      "reason": "Appointment created!",
      "data": "7a5f393c43b861105e0dbcba6ab8f29f"
      }
    }

## 약속 - POST /sn_apptmnt_booking/appointment/availability {#ariaid-title6}

약속 예약 서비스 구성에 구성된 슬롯을 해당 가용성과 함께 반환합니다.
서비스 구성에 고급 구성이 활성화된 경우 엔드포인트는 이러한 구성을 적용하고 규칙 및 고급 구성에 따라 데이터를 반환합니다. 또한 이 엔드포인트를 사용하여 요청 본문의 매개변수 또는 get_next_available_day_data 매개변수를 get_next_available_slot`true`로 전달하여 사용 가능한 첫 번째 슬롯을 찾을 수 있습니다.

이 엔드포인트에 액세스하려면 snc_internal 또는 snc_external 역할이 있어야 합니다.

### URL 형식 {#appt-POST-availability__section_yyz_lgd_nwb}

버전이 지정된 URL: /api/sn_apptmnt_booking/{api_version}/appointment/availability

기본 URL: /api/sn_apptmnt_booking/appointment/availability  
주:  
사용 가능한 버전은 [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를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#appt-POST-availability__entry__2}{#appt-POST-availability__version-not_optional-RESTAPI}

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

{#appt-POST-availability__entry__6}

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

{#appt-POST-availability__entry__10}

| 이름 | 설명 |
|-|-|
| catalog_id | 약속 예약 서비스 구성에 대해 구성된 기록 생성자의 Sys_id입니다. 이 매개변수를 전달하지 않으면 엔드포인트는 and task_table 매개변수에서 taskId 이 정보를 식별하려고 시도합니다. 그렇지 않으면 엔드포인트가 실패하고 오류가 반환됩니다. 데이터 유형: 문자열 테이블: 약속 예약 서비스 구성\[sn_apptmnt_booking_service_config\] 테이블의 관련 기록에 있는 카탈로그 항목 필드 |
| end_date | 필수 약속을 가져올 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC 시간대 및 YYYY-MM-dd HH:mm:ss 형식 |
| fetch_days_slot | 요청된 날짜 범위에 대해 매일 첫 번째 사용 가능한 슬롯을 반환할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 매일 사용 가능한 첫 번째 슬롯을 반환합니다. * false: 매일 사용 가능한 첫 번째 슬롯을 반환하지 않습니다. {#appt-POST-availability__ul_ujd_x4v_22c} 데이터 유형: 부울 기본값: false |
| full_day | 필수 시작 및 종료 날짜의 시간 값에 관계없이 경과된 지정된 날짜 범위의 모든 약속을 반환할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 지정된 시간에 관계없이 모든 약속을 반환합니다. * false: 지정된 날짜 및 시간에 해당하는 약속만 반환합니다. 데이터 유형: 부울 |
| get_next_available_slot | 전달 start_dateend_date 된 매개변수의 일부가 아니더라도 응답과 함께 사용 가능한 첫 번째 약속 슬롯을 반환할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 사용 가능한 첫 번째 약속 슬롯을 반환합니다. * false: 사용 가능한 첫 번째 약속 슬롯을 반환하지 않습니다. 데이터 유형: 부울 기본값: false |
| 제한 | 반환할 최대 약속 수입니다. 데이터 유형: 숫자 기본값: sn_apptmnt_booking .max_appointments_ returned 속성에 지정된 값 또는 속성이 비어 있는 경우 1000입니다. |
| 위치 | 필수 약속과 연결된 위치 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 위치 \[cmn_location\] |
| opened_for | 필수 약속을 예약 중인 사용자의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| otherInputs | 스크립팅된 메서드에서 가용성을 계산하는 데 필요한 다른 값의 이름-값 쌍입니다. 일반적으로 이러한 값은 카탈로그 항목 변수이지만 예약 애플리케이션을 사용자 지정하는 경우 구현에 필요한 모든 값을 전달할 수 있습니다. 예: "otherInputs": { "u_sn_point_of_sale_variable_set": "true", "short_description": "Point-of-Sale Installation", "contact": "6816f79cc0a8016401c5a33be04be441", "description": "Install new point-of-sale system with cash tray", "location": "32e8499cdb2d2200d75270f5bf9619d6" } 데이터 유형: 객체 |
| service_config_rule | 약속 슬롯과 가용성을 계산하는 데 사용할 서비스 구성 규칙의 Sys_id입니다. 데이터 유형: 문자열 테이블: 서비스 구성 규칙 \[sn_apptmnt_booking_config_rule\] |
| start_date | 필수 약속을 가져올 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC 시간대 및 YYYY-MM-dd HH:mm:ss 형식 |
| taskId | 약속이 예약되는 작업 기록의 Sys_id입니다. 날짜 유형: 문자열 테이블: 매개변수에 taskTable 정의됩니다. |
| task_table | 필수 약속이 예약되는 작업 기록이 포함된 테이블의 이름입니다. 데이터 유형: 문자열 |
| use_read_replica | 약속 슬롯과 해당 가용성을 가져올 때 데이터베이스의 읽기 복제본을 사용할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 데이터베이스의 읽기 복제본을 사용합니다. * false: 데이터베이스의 읽기 복제본을 사용하지 않습니다. 기본값: false |
| 뷰 | 필수 요청의 시작 지점입니다. 유효한 값: (대/소문자 구분) * 플랫폼 * 포털 데이터 유형: 문자열 |
[표 27. 요청 본문 매개변수]

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 28. 요청 헤더]

{#appt-POST-availability__entry__48}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 30. 상태 코드]

### 응답 본문 매개변수

{#appt-POST-availability__entry__60}

| 이름 | 설명 |
|-|-|
| 결과 | 요청과 일치하는 약속에 대한 상세 정보입니다. 데이터 유형: 객체 "result": { "availability": [Array], "has_more": Boolean, "next_available_slot": {Object}, "no_appt_available": Boolean, "success": Boolean, "time_zone": "String", "time_zone_display_value": "String" } |
| 결과.가용성 | 지정된 요청을 충족하는 약속 슬롯의 목록입니다. 데이터 유형: 객체 배열 "availability": [{ "available": Boolean, "end_date": "String", "end_date_display": "String", "end_dateUTC": "String", "start_date": "String", "start_date_display": "String", "start_dateUTC": "String" }] |
| 결과.가용성.사용 가능 | 연결된 시간 슬롯을 사용할 수 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 시간 슬롯을 사용할 수 있습니다. * false: 시간 슬롯을 사용할 수 없습니다. 데이터 유형: 부울 |
| result.availability.end_date | 연결된 약속의 종료 날짜 및 시간입니다. 시간대는 매개변수의 time_zone 값을 기반으로 합니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss |
| result.availability.end_date_display | 연결된 약속의 종료 날짜 및 시간을 표시합니다. 시간대는 매개변수의 time_zone_display_value 값을 기반으로 합니다. 데이터 유형: 문자열 형식: 사용자의 날짜 시간 형식을 요청합니다. |
| result.availability.end_dateUTC | 연결된 약속의 종료 날짜 및 시간(UTC 표준시)입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss |
| result.availability.start_date | 연결된 약속의 시작 날짜 및 시간입니다. 시간대는 매개변수의 time_zone 값을 기반으로 합니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss |
| result.availability.start_date_display | 연결된 약속의 시작 날짜 및 시간을 표시합니다. 시간대는 매개변수의 time_zone_display_value 값을 기반으로 합니다. 데이터 유형: 문자열 형식: 사용자의 날짜 시간 형식을 요청합니다. |
| result.availability.start_dateUTC | 연결된 약속의 시작 날짜 및 시간(UTC 표준시)입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss |
| result.has_more | 제한을 반환한 후 가져올 약속 슬롯이 더 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 더 많은 약속 슬롯을 사용할 수 있습니다. * false: 더 이상 사용할 수 있는 슬롯이 없습니다. 데이터 유형: 부울 |
| result.next_available_slot | 매개변수가 get_next_available_slot 예로 전달된 경우 경과된 시작 및 종료 날짜와 상관없이 첫 번째 사용 가능한 슬롯에 대한 세부 정보입니다. 데이터 유형: 객체 "next_available_slot": { "available": Boolean, "end_date": "String", "end_date_display": "String", "end_dateUTC": "String", "start_date": "String", "start_date_display": "String", "start_dateUTC": "String" } |
| result.next_available_slot.사용 가능 | 연결된 시간 슬롯을 사용할 수 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 시간 슬롯을 사용할 수 있습니다. * false: 시간 슬롯을 사용할 수 없습니다. 데이터 유형: 부울 |
| result.next_available_slot.end_date | 연결된 약속의 종료 날짜 및 시간입니다. 시간대는 매개변수의 time_zone 값을 기반으로 합니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss |
| result.next_available_slot.end_date_display | 연결된 약속의 종료 날짜 및 시간을 표시합니다. 시간대는 매개변수의 time_zone_display_value 값을 기반으로 합니다. 데이터 유형: 문자열 |
| result.next_available_slot.end_dateUTC | 연결된 약속의 종료 날짜 및 시간(UTC 표준시)입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss |
| result.next_available_slot.start_date | 연결된 약속의 시작 날짜 및 시간입니다. 시간대는 매개변수의 time_zone 값을 기반으로 합니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss |
| result.next_available_slot.start_date_display | 연결된 약속의 시작 날짜 및 시간을 표시합니다. 시간대는 매개변수의 time_zone_display_value 값을 기반으로 합니다. 데이터 유형: 문자열 |
| result.next_available_slot.start_dateUTC | 연결된 약속의 시작 날짜 및 시간(UTC 표준시)입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss |
| result.no_appt_available | 지정된 날짜 및 시간에 사용할 수 있는 약속 슬롯이 더 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 더 많은 약속 시간 슬롯을 사용할 수 있습니다. * false: 더 이상 사용할 수 있는 약속 시간 슬롯이 없습니다. 데이터 유형: 부울 |
| 결과.성공 | 엔드포인트 호출이 성공했는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 엔드포인트 호출에 성공했습니다. * false: 엔드포인트 호출에 실패했습니다. 데이터 유형: 부울 |
| result.time_zone | 약속 슬롯이 렌더링된 시간대입니다. 약속 예약 서비스 구성의 값을 기준으로 합니다. 데이터 유형: 문자열 |
| result.time_zone_display_value | 약속 슬롯이 렌더링된 시간대를 표시합니다. 약속 예약 서비스 구성의 값을 기준으로 합니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

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

    curl "http://instance.servicenow.com/api/sn_apptmnt_booking/v1/appointment/availability" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"start_date\": \"2023-02-05 05:00:00\",
      \"end_date\": \"2023-02-07 04:59:59\",
      \"location\": \"32e8499cdb2d2200d75270f5bf9619d6\",
      \"catalog_id\": \"e4c1116b3b810300ce8a4d72f3efc40f\",
      \"opened_for\": \"6816f79cc0a8016401c5a33be04be441\",
      \"full_day\": false,
      \"task_table\": \"wm_order\",
      \"view\": \"portal\",
      \"get_next_available_slot\": true,
      \"use_read_replica\": true,
      \"service_config_rule\": \"f7d5d98f437c21105e0dbcba6ab8f2fc\"
    }" \
    --user 'username':'password

응답:

    {
    "result": {
      "success": true,
      "availability": [
        {
          "start_date": "2023-02-06 09:00:00",
          "end_date": "2023-02-06 11:00:00",
          "start_date_display": "09:00",
          "end_date_display": "11:00",
          "start_dateUTC": "2023-02-06 14:00:00",
          "end_dateUTC": "2023-02-06 16:00:00",
          "available": false
        },
        {
          "start_date": "2023-02-06 13:00:00",
          "end_date": "2023-02-06 15:00:00",
          "start_date_display": "13:00",
          "end_date_display": "15:00",
          "start_dateUTC": "2023-02-06 18:00:00",
          "end_dateUTC": "2023-02-06 20:00:00",
          "available": false
        },
        {
          "start_date": "2023-02-06 15:00:00",
          "end_date": "2023-02-06 17:00:00",
          "start_date_display": "15:00",
          "end_date_display": "17:00",
          "start_dateUTC": "2023-02-06 20:00:00",
          "end_dateUTC": "2023-02-06 22:00:00",
          "available": false
        }
      ],
      "has_more": false,
      "no_appt_available": true,
      "time_zone": "US/Eastern",
      "time_zone_display_value": "US/Eastern",
      "next_available_slot": {
        "start_date": "2023-02-10 13:00:00",
        "end_date": "2023-02-10 15:00:00",
        "start_date_display": "13:00",
        "end_date_display": "15:00",
        "start_dateUTC": "2023-02-10 18:00:00",
        "end_dateUTC": "2023-02-10 20:00:00",
        "available": true
    }