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


---

# API de modificação de dados JSON

# API de modificação de dados JSON {#ariaid-title1}

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

Modifique os dados usando o serviço Web JSON enviando uma solicitação HTTPS POST para a instância.  
O HTTP POST deve conter um parâmetro `sysparm_action` para indicar o tipo de ação a ser executada, com a publicação do objeto JSON de entrada no corpo.  
Nota:  
O tipo de conteúdo do POST deve ser application/json. Não pode ser application/x-www-form-urlencoded ou multipart/form-data.

## inserir

Crie um novo registro em ServiceNow. O objeto JSON deve ser POSTado como o corpo (o tipo de conteúdo geralmente é aplicação/json, embora não seja imposto). A resposta da criação do registro é um objeto JSON do incidente que foi criado.  
Por exemplo, publicar o seguinte objeto JSON:

    {"short_description":"this is a test","priority":"1"}

para o seguinte URL:

    https://your_instance.service-now.com/incident.do?JSONv2&sysparm_action=insert

cria um incidente.  
Opcionalmente, você também pode especificar o sysparm_action no objeto JSON. O parâmetro dentro do objeto JSON tem precedência sobre o parâmetro de URL. Por exemplo:

    {"sysparm_action":"insert","short_description":"this is a test","priority":"1"}

## inserirvários

Para criar vários novos registros em ServiceNow, o objeto JSON de entrada para a função de inserção deve ser uma matriz. A resposta da criação do registro é um objeto JSON dos incidentes que foram criados. Por exemplo, o seguinte objeto JSON:

    { "records" : [ { "short_description" : "this was inserted with python using JSON 1" , "priority" : "1 - Critical" , "impact" : "1" , "caller_id" : "Fred Luddy" } , { "short_description" : "this was inserted with python using JSON 2" , "priority" : "1 - Critical" , "impact" : "1" , "caller_id" : "Fred Luddy" } ] }

publicado em um dos seguintes URLs:

    https://<instance name>.service-now.com/incident.do?JSONv2&sysparm_action=insert
    https://<instance name>.service-now.com/incident.do?JSONv2&sysparm_action=insertMultiple

cria dois incidentes. Observe os campos descritos como um valor de matriz para o campo de registros.

## atualizar

Atualize um registro ou uma lista de registros filtrados por uma cadeia de caracteres de consulta codificada especificada pelo parâmetro de URL `sysparm_query`. O objeto JSON deve ser publicado como o corpo (o tipo de conteúdo geralmente é aplicação/json, embora não seja imposto). A resposta da criação do registro é uma matriz de objetos JSON que representa os registros que foram atualizados.  
Por exemplo, publicar o seguinte objeto JSON:

    {"short_description":"this was updated with python", "priority": "3", "impact":"1"}

para o seguinte URL:

    https://instance_name.service-now.com/incident.do?JSONv2&sysparm_query=priority=3&sysparm_action=update

atualiza todos os incidentes com prioridade 3 e define os valores especificados pelo objeto JSON.

## excluirRegistro

Exclua um único registro da tabela de destino, identificado por um parâmetro `sysparm_sys_id`. O parâmetro pode ser codificado no objeto JSON de entrada ou fornecido como um parâmetro de URL.  
Por exemplo, publicar:

    {"sysparm_sys_id":"fd4001f80a0a0b380032ffa2b749927b"}

para o seguinte URL:

    http://instance_name.service-now.com/incident.do?JSONv2&sysparm_action=deleteRecord

exclui o registro de incidente identificado pelo sys_id fd4001f80a0a0b380032ffa2b749927b.

## excluirvários

Exclua vários registros da tabela de destino, filtrados por uma cadeia de caracteres de consulta codificada especificada no parâmetro de URL `sysparm_query`. O filtro também pode ser codificado no objeto JSON de entrada.  
Por exemplo, publicar:

    {"sysparm_query":"short_description=this was updated with python"}

para o seguinte URL:

    http://instance_name.service-now.com/incident.do?JSONv2&sysparm_action=deleteMultiple

exclui todos os registros de incidentes em que o campo `short_description` contém o valor "este foi atualizado com python".