---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API de modification de données JSON

# API de modification de données JSON {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

Modifiez les données à l'aide du service Web JSON en envoyant une demande HTTPS POST à l'instance.  
Le HTTP POST doit contenir un paramètre `sysparm_action` pour indiquer le type d'action à effectuer, avec la publication de l'objet JSON entrant dans le corps.  
Remarque :  
Le type de contenu de l'auto-test de démarrage (POST) doit être application/json. Il ne peut pas s'agir d'application/x-www-form-urlencoded ou de multipart/form-data.

## insérer

Créez un nouvel enregistrement dans ServiceNow. L'objet JSON doit être POST en tant que corps (le type de contenu est généralement application/json, bien qu'il ne soit pas appliqué). La réponse à la création de l'enregistrement est un objet JSON de l'incident qui a été créé.  
Par exemple, publication de l'objet JSON suivant :

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

à l'URL suivante :

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

Crée un incident.  
Si vous le souhaitez, vous pouvez également spécifier le sysparm_action dans l'objet JSON. Le paramètre à l'intérieur de l'objet JSON est prioritaire sur le paramètre URL. Par exemple :

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

## insérerMultiple

Pour créer plusieurs enregistrements dans ServiceNow, l'objet JSON d'entrée de la fonction insert doit être un tableau. La réponse à la création de l'enregistrement est un objet JSON des incidents qui ont été créés. Par exemple, l'objet JSON suivant :

    { "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" } ] }

publié à l'une des URL suivantes :

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

Crée deux incidents. Notez les champs décrits sous forme de tableau de valeurs pour le champ Enregistrements .

## mettre à jour

Mettez à jour un enregistrement ou une liste d'enregistrements filtrés par une chaîne de requête codée spécifiée par le paramètre URL `sysparm_query` . L'objet JSON doit être publié en tant que corps (le type de contenu est généralement application/json, bien qu'il ne soit pas appliqué). La réponse de la création d'enregistrement est un tableau d'objets JSON représentant les enregistrements qui ont été mis à jour.  
Par exemple, publication de l'objet JSON suivant :

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

à l'URL suivante :

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

met à jour tous les incidents avec une priorité 3 et définit les valeurs spécifiées par l'objet JSON.

## deleteRecord

Supprimez un seul enregistrement de la table ciblée, identifié par un paramètre `sysparm_sys_id` . Le paramètre peut être encodé dans l'objet JSON d'entrée ou donné comme paramètre d'URL.  
Par exemple, en publiant :

    {"sysparm_sys_id":"fd4001f80a0a0b380032ffa2b749927b"}

à l'URL suivante :

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

Supprime l'enregistrement d'incident identifié par le sys_id FD4001F80A0A0B380032FFA2B749927B.

## deleteMultiple

Supprimez plusieurs enregistrements de la table ciblée, filtrés par une chaîne de requête codée spécifiée dans le paramètre URL `sysparm_query` . Le filtre peut également être encodé dans l'objet JSON d'entrée.  
Par exemple, en publiant :

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

à l'URL suivante :

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

Supprime tous les enregistrements d'incidents dans lesquels le champ `short_description` contient la valeur \<\< ceci a été mis à jour avec Python \>\>.