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


---

# 스크립팅된 REST API 작성

# 스크립팅된 REST API 작성 {#ariaid-title1}

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

웹 서비스 엔드포인트를 정의하는 스크립트 기반 REST API를 만듭니다.

## 시작하기 전에

필요한 역할: web_service_admin

## 프로시저

1. 다음으로 이동 모두시스템 웹 서비스스크립트 기반 REST API.
2. 새로 만들기를 클릭합니다.
3. 서비스의 이름을 입력합니다.  
   API ID는 이름에 따라 자동으로 설정됩니다. 필요한 경우 API ID 를 수정할 수 있습니다.
4. 기본 ACL 필드에서 API의 모든 자원에 적용되는 기본 ACL을 선택합니다.  
   ACL을 포함하여 API의 자원에 대한 보안 설정을 구성하는 경우 자원의 설정이 상위 API 설정을 재정의합니다.
5. 제출을 클릭합니다.
{#t_CreateAScriptedRESTService__steps_nmg_dld_cs}

## 다음에 수행할 작업

API를 만든 후에는 자원 만들기, ACL 할당 또는 지원되는 요청 및 응답 형식 지정 등 필요에 따라 서비스를 구성합니다.
* **[스크립팅된 REST API 자원 생성](https://servicenow-prod.fluidtopics.net/seqzGDajT8QPRDo62RD7mg)**   
  HTTP 메서드와 처리 스크립트를 정의하고 상위 서비스의 설정을 재정의하는 스크립트된 REST API 자원을 만듭니다.
* **[REST API 응답 헤더 정의](https://servicenow-prod.fluidtopics.net/Z9BxV1OeEwW1u84tXoWEBg)**   
  REST API에서 하나 이상의 REST API 응답 헤더를 정의합니다.
* **[정의 스크립트된 REST API 요청 헤더](https://servicenow-prod.fluidtopics.net/RXyKjinNxgWEWO8Q_4N94Q)**   
  스크립트된 REST API 요청 헤더를 정의하여 API가 수락 헤더를 제어합니다.
* **[요청 헤더를 자원과 연결](https://servicenow-prod.fluidtopics.net/5IoqLSN~RWeUGJm2zJ4Ppg)**   
  스크립팅된 REST API 내의 각 자원에 필요한 요청 헤더를 정의합니다.
* **[REST API 스키마 정의](https://servicenow-prod.fluidtopics.net/7izss0Q1cFD7xaYA9kqkgg)**   
  스키마를 정의하여 REST API 내에서 요청 또는 응답에 대한 예상 데이터 구조를 지정합니다.
* **[API 자원 요청 구조 정의](https://servicenow-prod.fluidtopics.net/ek0G0j3UqNbRRbiS01o25Q)**   
  REST 요청 기록에 스키마를 추가하여 요청의 예상 데이터 구조를 정의합니다.
* **[API 자원 응답 구조 정의](https://servicenow-prod.fluidtopics.net/UiHZIf6gInTJPy_7DrAE0Q)**   
  REST 응답에 스키마 및 관련 응답 헤더를 추가하여 응답의 예상 데이터 구조를 정의합니다.
* **[사용 가능한 쿼리 매개변수 정의](https://servicenow-prod.fluidtopics.net/zHnCEL_t9ldbYjABaU~wkg)**   
  사용 가능한 쿼리 매개변수를 정의하여 요청 사용자가 요청 URI에 전달할 수 있는 값을 제어합니다.
* **[쿼리 매개변수를 자원과 연결](https://servicenow-prod.fluidtopics.net/Oo53wB0V0DuYjgBuh7~UhQ)**   
  스크립트된 REST API 쿼리 매개변수를 자원과 연결합니다.
* **[API 요청 정의 자동 생성](https://servicenow-prod.fluidtopics.net/Y34wsAW6FZamUB3z~DJovw)**   
  API 자원에 대한 샘플 요청을 사용하여 해당 자원에 대한 요청 헤더 연결, 쿼리 매개변수 연결 및 요청 스키마를 생성합니다.
* **[ACL을 요구하도록 스크립트된 REST API 구성](https://servicenow-prod.fluidtopics.net/AnWVuf4Bok9gDGXfV4jBTg)**   
  스크립트된 REST API에 대한 요청은 플랫폼 ACL을 준수하며, 요청하는 사용자가 인스턴스 데이터에 액세스하려면 테이블 ACL 요구 사항을 충족해야 합니다. 또한 특정 ACL을 요구하도록 스크립트된 REST API를 구성할 수 있습니다.
* **[스크립트된 REST API에 버전 관리 사용](https://servicenow-prod.fluidtopics.net/3Nq5hUBGCJhJz7y3wjVzQQ)**   
  스크립트된 REST API에 대한 버전 관리를 활성화하여 기존 통합과의 호환성을 유지하면서 여러 버전의 API를 제공합니다.
* **[통제 요청 및 응답 콘텐츠 유형](https://servicenow-prod.fluidtopics.net/GPtARjglcQ8RG0h1xHvevQ)**   
  스크립트된 REST API 요청 및 응답에 허용되는 콘텐츠 유형을 제어합니다.
* **[최대 요청 크기 제어](https://servicenow-prod.fluidtopics.net/A_5~Y0Uyg6CWicwwX0nduw)**   
  스크립팅된 REST API 요청 페이로드에 허용되는 최대 파일 크기를 지정할 수 있습니다.