---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# JSON-Datenänderungs-API

# JSON-Datenänderungs-API {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Ändern Sie die Daten mithilfe des JSON-Webservices, indem Sie eine HTTPS-POST-Anforderung an die Instanz senden.  
Der HTTP-POST muss einen Parameter `sysparm_action` enthalten, der den Typ der auszuführenden Aktion angibt, wobei das eingehende JSON-Objekt im Textkörper veröffentlicht wird.  
Hinweis:  
Der Content Typ des POST sollte „application/json" sein. Es kann nicht „application/x-www-form-urlencoded" oder „multipart/form-data" sein.

## insert

Erstellen Sie einen neuen Datensatz in ServiceNow. Das JSON-Objekt muss als Textkörper veröffentlicht werden (Content Typ ist normalerweise „application/json", wird jedoch nicht erzwungen). Die Antwort von der Datensatzerstellung ist ein JSON-Objekt des Incidents, der erstellt wurde.  
Zum Beispiel das Veröffentlichen des folgenden JSON-Objekts:

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

zur folgenden URL:

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

erstellt einen Incident.  
Optional können Sie auch die „sysparm_action" im JSON-Objekt angeben. Der Parameter im JSON-Objekt hat Vorrang vor dem URL-Parameter. Beispiel:

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

## insertMultiple

Um mehrere neue Datensätze in ServiceNow zu erstellen, muss das Eingabe-JSON-Objekt für die -Funktion zum Einfügen ein Array sein. Die Antwort von der Datensatzerstellung ist ein JSON-Objekt der erstellten Incidents. Beispielsweise das folgende JSON-Objekt:

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

zu einer der folgenden URLs veröffentlicht:

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

erstellt zwei Incidents. Beachten Sie die Felder, die als Arraywert für das Feld records beschrieben werden.

## update

Aktualisiert einen Datensatz oder eine Liste von Datensätzen, die nach einer kodierten Abfragezeichenfolge gefiltert wurden, die durch den URL-Parameter `sysparm_query` angegeben wurde. Das JSON-Objekt muss als Textkörper veröffentlicht werden (Content Typ ist normalerweise „application/json", wird jedoch nicht erzwungen). Die Antwort von der Datensatzerstellung ist ein Array von JSON-Objekten, die die aktualisierten Datensätze darstellen.  
Zum Beispiel das Veröffentlichen des folgenden JSON-Objekts:

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

zur folgenden URL:

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

aktualisiert alle Incidents mit Priorität 3, und legt die vom JSON-Objekt angegebenen Werte fest.

## deleteRecord

Löscht einen einzelnen Datensatz aus der Zieltabelle, der durch einen Parameter `sysparm_sys_id` gekennzeichnet ist. Der Parameter kann im Eingabe-JSON-Objekt kodiert oder als URL-Parameter angegeben werden.  
Zum Beispiel wird durch:

    {"sysparm_sys_id":"fd4001f80a0a0b380032ffa2b749927b"}

zur folgenden URL:

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

der durch die sys_id fd4001f80a0a0b380032ffa2b749927b identifizierte Incident-Datensatz gelöscht.

## deleteMultiple

Löscht mehrere Datensätze aus der Zieltabelle, gefiltert nach einer kodierten Abfragezeichenfolge, die im URL-Parameter `sysparm_query` angegeben ist. Der Filter kann auch im Eingabe-JSON-Objekt kodiert sein.  
Zum Beispiel wird durch:

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

zur folgenden URL:

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

alle Incident-Datensätze gelöscht, in denen das Feld `short_description` den Wert „Dies wurde mit Python aktualisiert" enthält.