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


---

# Serviço Web JSONv2

# Serviço Web JSONv2 {#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

A capacidade de descrever conjuntos de dados no formato JSON é uma extensão natural da linguagem JavaScript.

ServiceNow O oferece suporte a uma interface de serviço da Web que opera no objeto JSON como o formato de entrada e saída de dados.  
O serviço Web JSONv2 é fornecido por um processador no nível da plataforma semelhante aos serviços para SOAP, WSDL, CSV, Excel e XML. Como esses serviços, o serviço Web JSON é acionado por um parâmetro de URL JSONv2 autônomo. Por exemplo:

    https://<instance name>.service-now.com/mytable.do?JSONv2

Ter o objeto JSON disponível como um formato de dados para serviços Web significa que você pode criar (inserir), atualizar e consultar quaisquer dados no sistema usando o formato de objeto JSON e obter resultados no formato de objeto JSON.

## Segurança

Como todos os outros serviços web baseados em HTTP disponíveis na plataforma, o serviço web JSONv2 é necessário para autenticar usando autenticação básica por padrão. O ID do usuário usado para autenticação está sujeito ao controle de acesso da mesma forma que um usuário interativo.
* **[Formato de objeto JSON](https://servicenow-prod.fluidtopics.net/qONXydyTh~3JXjrRQa5nWQ)**   
  O objeto JSON é criado em duas estruturas.
* **[Status da resposta JSON](https://servicenow-prod.fluidtopics.net/RAyXajmV9cKU1YNHyz4RlA)**   
  As solicitações JSONv2 podem retornar um dos vários status de resposta.
* **[Definir o número de linhas retornadas](https://servicenow-prod.fluidtopics.net/KjcH6FoU8ZHydsY5gCE4GQ)**   
  A propriedade do sistema a seguir controla quantas linhas o JSON retorna com cada consulta.
* **[Requer autenticação básica para solicitações de JSONv2 recebidas](https://servicenow-prod.fluidtopics.net/Bh~tmIgYjqUj_1kyr3hfBg)**   
  A propriedade do sistema a seguir controla se a autenticação básica é necessária para solicitações JSONv2 de entrada.
* **[Parâmetros da ação](https://servicenow-prod.fluidtopics.net/OfOlclsQrp2lu1gsEHhVMQ)**   
  Os parâmetros de ação são separados e diferentes dos parâmetros de dados porque especificam a ação a ser executada quando o parâmetro de objeto JSON faz parte de uma solicitação HTTP GET ou POST.
* **[API de recuperação de dados JSON](https://servicenow-prod.fluidtopics.net/8790puYw6U2PE99FiEmzZw)**   
  Consulta de dados emitindo uma solicitação HTTPS GET para a instância.
* **[API de modificação de dados JSON](https://servicenow-prod.fluidtopics.net/~6NVcOCCeMWjwuNZO8r9hw)**   
  Modifique os dados usando o serviço Web JSON enviando uma solicitação HTTPS POST para a instância.

**Conceitos relacionados**   

* [Segurança de serviços web SOAP](https://servicenow-prod.fluidtopics.net/ulD7LS4EcE9mzBLrVmaEZw "O SOAP (Simple Object Access Protocol) é um protocolo baseado em XML para acessar serviços da Web em HTTP.")