---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Criar uma REST API com script

# Criar uma REST API com script {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

Crie uma REST API com script para definir endpoints de serviço web.

## Antes de Iniciar

Função necessária: web_service_admin

## Por Que e Quando Desempenhar Esta Tarefa

Por padrão, as REST APIs com script contêm uma ACL que proíbe usuários com a função snc_external de fazer solicitações à API.

## Procedimento

1. Navegar até TodosServiços web do sistemaScripted REST APIs.
2. Clique em Nova.
3. Insira um Nome para o serviço.  
   O ID da API é definido automaticamente com base no Nome. Você pode modificar o ID da API, se necessário.
4. Clique em Enviar.
{#t_CreateAScriptedRESTService__steps_nmg_dld_cs}

## O que Fazer Depois

Depois de criar a API, configure o serviço conforme necessário, como criando recursos, atribuindo ACLs ou especificando formatos de solicitação e resposta compatíveis.
* **[Criar um recurso de REST API com script](https://servicenow-prod.fluidtopics.net/kDReSwor5NjKYByBThnHJg)**   
  Crie um recurso de API REST com script para definir o método HTTP, o script de processamento e para substituir as configurações do serviço primário.
* **[Definir cabeçalhos de API REST com script](https://servicenow-prod.fluidtopics.net/MsofcCrZjKEZFB6HHsQA8Q)**   
  Defina cabeçalhos de REST API com script para controlar quais cabeçalhos a API aceita e com os quais pode responder.
* **[Definir parâmetros de consulta disponíveis](https://servicenow-prod.fluidtopics.net/3aLXkmYoFC9fDf8vXJI0ag)**   
  Defina os parâmetros de consulta disponíveis para controlar quais valores um usuário solicitante pode passar no URI de solicitação.
* **[Associar parâmetros de consulta a um recurso](https://servicenow-prod.fluidtopics.net/m~Of87GiYNUpmfbiY8amxg)**   
  Associe parâmetros de consulta de REST API de script a um recurso.
* **[Configurar uma REST API com script para exigir uma ACL](https://servicenow-prod.fluidtopics.net/~IOQwhldOkQf~pxj~fSoTA)**   
  As solicitações para REST APIs com script respeitam as ACLs da plataforma e o usuário solicitante deve atender a todos os requisitos de ACL da tabela para acessar os dados da instância. Além disso, você pode configurar a REST API com script para exigir uma ACL específica.
* **[Habilitar controle de versões para uma REST API com script](https://servicenow-prod.fluidtopics.net/CQywjSQVteU1XhePa78deQ)**   
  Habilite o controle de versões de uma REST API com script para fornecer várias versões da API enquanto mantém a compatibilidade com as integrações existentes.
* **[Solicitação de controle e tipo de conteúdo de resposta](https://servicenow-prod.fluidtopics.net/xnzIXURQhlKSKrkrE7~JtA)**   
  Controla quais tipos de conteúdo são permitidos em solicitações e respostas de API REST de script.
* **[Como controlar o tamanho máximo da solicitação](https://servicenow-prod.fluidtopics.net/G7Ya2sQZfn1_IpJq8NsLmg)**   
  Você pode especificar o tamanho máximo de arquivo permitido em uma carga de solicitação de REST API com script.