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

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 스크립팅된 REST API 작성

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

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

스크립팅된 REST API를 작성하여 웹 서비스 엔드포인트를 정의합니다.

## 시작하기 전에

필요한 역할: web_service_admin

## 이 태스크 정보

기본적으로 스크립트 기반 REST API에는 snc_external 역할을 가진 사용자가 API에 요청하지 못하도록 하는 ACL이 포함되어 있습니다.

## 프로시저

1. 다음으로 이동 모두시스템 웹 서비스스크립트 기반 REST API.
2. 새로 만들기를 클릭합니다.
3. 서비스의 이름을 입력합니다.  
   API ID는 이름에 따라 자동으로 설정됩니다. 필요한 경우 API ID 를 수정할 수 있습니다.
4. 제출을 클릭합니다.
{#t_CreateAScriptedRESTService__steps_nmg_dld_cs}

## 다음에 수행할 작업

API를 생성한 후 자원 생성, ACL 할당 또는 지원되는 요청 및 응답 형식 지정과 같이 필요에 따라 서비스를 구성합니다.
* **[스크립팅된 REST API 자원 작성](https://servicenow-prod.fluidtopics.net/EaJVTMAlnyKIlxWav__16w)**   
  스크립트 기반 REST API 자원을 생성하여 HTTP 메서드, 처리 스크립트를 정의하고 상위 서비스의 설정을 재정의합니다.
* **[스크립팅된 REST API 헤더 정의](https://servicenow-prod.fluidtopics.net/GlliO1tY8_9O35RhOpj4jA)**   
  스크립트된 REST API 헤더를 정의하여 API가 수락하고 응답할 수 있는 헤더를 제어합니다.
* **[사용 가능한 쿼리 매개변수 정의](https://servicenow-prod.fluidtopics.net/LlY2YnmtgONcNFEhUOemqg)**   
  사용 가능한 쿼리 매개변수를 정의하여 요청하는 사용자가 요청 URI에 전달할 수 있는 값을 제어합니다.
* **[자원에 쿼리 매개변수 연결](https://servicenow-prod.fluidtopics.net/XeBR8z6wWojt8hs2RB1z6A)**   
  스크립팅된 REST API 쿼리 매개변수를 자원에 연결합니다.
* **[ACL을 요구하도록 스크립트된 REST API 구성](https://servicenow-prod.fluidtopics.net/QNi7AuzCgPpBImh~8CX8UQ)**   
  스크립트된 REST API에 대한 요청은 플랫폼 ACL을 준수하며, 요청하는 사용자는 인스턴스 데이터에 액세스하기 위해 테이블 ACL 요구 사항을 충족해야 합니다. 또한 특정 ACL을 요구하도록 스크립트된 REST API를 구성할 수 있습니다.
* **[스크립트된 REST API에 대해 버전 관리 사용](https://servicenow-prod.fluidtopics.net/D7bjooWm~DbFiot9fUXMUg)**   
  기존 통합과의 호환성을 유지하면서 여러 버전의 API를 제공하려면 스크립트된 REST API에 대해 버전 관리를 사용하십시오.
* **[요청 및 응답 콘텐츠 유형 통제](https://servicenow-prod.fluidtopics.net/bCFUlsug2MZWZucKOgb6jQ)**   
  스크립팅된 REST API 요청 및 응답에 허용되는 컨텐츠 유형을 제어합니다.
* **[최대 요청 크기 제어](https://servicenow-prod.fluidtopics.net/Muy3vAiDFc4xkS4Nj5_w0w)**   
  스크립팅된 REST API 요청 페이로드에 허용되는 최대 파일 크기를 지정할 수 있습니다.