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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# JSON-Datenänderungs-API

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

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Ändern Sie Daten mit dem JSON-Webservice, indem Sie eine HTTPS-POST-Anforderung an die Instanz senden.  
Der HTTP-POST muss einen enthalten `Sysparm_action `Parameter, der den Typ der auszuführenden Aktion mit dem eingehenden JSON-Objekt-Post im Text angibt.  
Hinweis:  
Der Inhaltstyp des BEITRAGS muss „Application/JSON" sein. Es kann nicht „Application/x-www-Form-urlencoded" oder „Multipart/Form-Data" sein.

## einfügen

Erstellen Sie einen neuen Datensatz in ServiceNow. Das JSON-Objekt muss als Text veröffentlicht werden (Inhaltstyp ist normalerweise „Application/JSON", obwohl nicht erzwungen). Die Antwort aus der Datensatzerstellung ist ein JSON-Objekt des erstellten Incidents.  
Beispiel: Das folgende JSON-Objekt wird veröffentlicht:

    {"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 die sysparm_action auch im JSON-Objekt angeben. Der Parameter im JSON-Objekt hat Vorrang vor dem URL-Parameter. Zum Beispiel:

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

## EinfügeMultiple

Um mehrere neue Datensätze in zu erstellen ServiceNow, Das Eingabe-JSON-Objekt für Die Einfügefunktion muss ein Array sein. Die Antwort aus der Datensatzerstellung ist ein JSON-Objekt der erstellten Incidents. Beispiel: 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" } ] }

In 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 Array-Wert für beschrieben sind Datensätze Feld.

## Aktualisieren

Aktualisieren Sie einen Datensatz oder eine Liste von Datensätzen, die nach gefiltert werden Codierte Abfragezeichenfolge, die von angegeben wird `Sysparm_query `URL-Parameter. Das JSON-Objekt muss als Text veröffentlicht werden (Inhaltstyp ist normalerweise „Application/JSON", obwohl nicht erzwungen). Die Antwort der Datensatzerstellung ist ein Array von JSON-Objekten, die die aktualisierten Datensätze darstellen.  
Beispiel: Das folgende JSON-Objekt wird veröffentlicht:

    {"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öschen Sie einen einzelnen Datensatz aus der Zieltabelle, der durch gekennzeichnet ist `Sysparm_sys_ID `Parameter. Der Parameter kann im Eingabe-JSON-Objekt codiert oder als URL-Parameter angegeben werden.  
Beispiel: Veröffentlichung:

    {"sysparm_sys_id":"fd4001f80a0a0b380032ffa2b749927b"}

Zur folgenden URL:

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

Löscht den Incident-Datensatz, der durch die sys_ID fd4001f80a0a0b380032ffa2b749927b identifiziert wird.

## DeleteMultiple

Löschen Sie mehrere Datensätze aus der Zieltabelle, gefiltert nach Codierte Abfragezeichenfolge, die in angegeben ist `Sysparm_query `URL-Parameter. Der Filter kann auch im Eingabe-JSON-Objekt codiert werden.  
Beispiel: Veröffentlichung:

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

Zur folgenden URL:

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

Löscht alle Incident-Datensätze, bei denen `Short_description `Feld enthält den Wert „wurde mit Python aktualisiert".

