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

# Criar uma mensagem REST {#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

Envie solicitações para um endpoint de serviço web REST criando um registro de mensagem REST.

## Antes de Iniciar

Função necessária: web_service_admin

## Procedimento

1. Navegar até TodosServiços web do sistemaMensagem REST.
2. Clique em Nova.
3. Preencha os seguintes campos:  
   {#t_ConfiguringARESTMessage__table_RestMessageForm__entry__2}

   | Campo | Descrição |
   |-|-|
   | Nome | Insira um nome descritivo para esta mensagem. |
   | Endpoint | Insira o endpoint para o qual esta mensagem REST é enviada. O valor do endpoint pode incluir variáveis usando o formato ${variable}. |
   | Tipo de autenticação | Selecione o tipo de autenticação a ser usado, se houver, e o registro de perfil que contém as credenciais do usuário. O REST de saída é compatível com autenticação básica e OAuth 2.0. O REST de saída oferece suporte à autenticação mútua somente com autenticação básica. A autenticação configurada aqui é herdada pelos métodos HTTP associados. Você pode configurar a autenticação para cada método que substitui qualquer configuração de autenticação no nível da mensagem. |
   | Cabeçalhos HTTP | Clique duas vezes em uma linha na lista integrada Cabeçalhos HTTP para definir o Nome e o Valordo cabeçalho. O provedor de serviço web determina quais cabeçalhos são compatíveis ou necessários. |
   [Tabela 1. Formulario da mensagem REST]

   {#t_ConfiguringARESTMessage__table_RestMessageForm}
4. Clique em Enviar.  
   Depois de criar a mensagem REST, um método GET HTTP é criado automaticamente usando os valores do registro da mensagem REST.

## O que Fazer Depois

Crie ou edite métodos HTTP e execute uma solicitação.
* **[Definir um método HTTP de mensagem REST](https://servicenow-prod.fluidtopics.net/3bQ3_yUczK21GYezbs~YPw)**   
  Defina um método HTTP, como GET ou POST, para enviar uma solicitação a um provedor de serviço web.
* **[Definir um cabeçalho HTTP de mensagem REST](https://servicenow-prod.fluidtopics.net/SRGRE1jRB1VHajzWKmtAig)**   
  Defina um cabeçalho HTTP para uma mensagem REST ou método HTTP para enviar esse cabeçalho com solicitações REST.
* **[Envio de mensagens REST de saída por meio de um MID Server](https://servicenow-prod.fluidtopics.net/fZ8o4Nnh9QIQ8~vzGihC5g)**   
  Você pode configurar um método HTTP de mensagem REST a ser enviado por meio de um MID Server.
* **[Uso de caracteres especiais em URIs](https://servicenow-prod.fluidtopics.net/yapLR1aAjnHhA6icdnEt~A)**   
  Um URI de função REST ou uma variável de função podem usar caracteres especiais, como caracteres pipe (\|).