Patch-Gegenstand

Patch-Gegenstand #

Aktualisiert eine bestimmte Menge von Eigenschaften eines Verzeichniselements. Für Änderungen verwendet dies das Patch-Format JSON Patch.

PATCH /v1.0/contactdirectories/{DIRECTORY_ID}/items/{DIRECTORY_ITEM_ID}

Beispiel #

Diese Anfrage fügt einem bestehenden Verzeichniseintrag ein neues Telefonfeld hinzu.

Anfrage # 

PATCH <https://api.na.myreports.cloud/api/v1.0/contactdirectories/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000123> HTTP/1.1
Inhaltstyp: application/json
Akzeptanz-Gebühren: Wahr
Autorisierung: Inhaber {TOKEN}
Verbindung: am Leben bleiben
{
    "Pfad": "/Felder/Telefon2",
    "op": "add",
    "Wert": "+44YYYYYYYYYY"
}

Reaktion # 

HTTP/1.1 201 erstellt
Inhaltstyp: application/json; charset=utf-8
Inhalt-Länge: xx
Ort: <https://api.na.myreports.cloud/api/v1.0/contactdirectories/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000123>
{
	"data": {
        "id": "00000000-0000-0000-00000-00000000123",
        "Felder": {
            "Titel": "Herr",
            "fullName": "CRM3a",
            "Firmenname": "Unternehmen",
            "JobTitle": "Jobtitel",
            "phone1": "+44XXXXXXXXXX",
            "phone2": "+44YYYYYYYYYYYYY",
            "E-Mail": "E-Mail-Adresse",
            "Feld1": "Feld1",
            "Feld2": "Feld2",
            "crmId": "00000000-0000-0000-000000-0000000001"
        }
    },
	"Status": "Erfolg",
	"Zeitstempel": "2019-11-29T16:03:23.9251680Z"
}

Fehler #

Unautorisiert #

Wenn der Token nicht bereitgestellt wird, ungültig oder abgelaufen ist 

HTTP/1.1 401 Unautorisiert

Schlechte Anfrage #

Wenn die bereitgestellte Verzeichnis-Item-ID nicht im korrekten Format ist 

HTTP/1.1 400 Bad Request
Datum: Do, 06. Feb 2020 12:45:27 GMT
Inhaltstyp: application/json; charset=utf-8
Inhalt-Länge: 149
{
	"Fehler": 400,
	"Nachricht": "Der Wert '<tenant id>'ist nicht gültig.",
	"status": "fehler",
	"Zeitstempel": "2020-02-06T12:45:27.5903465Z"
}

Nicht gefunden #

Wenn es keine Verzeichniseinträge gibt, die eine passende ID haben 

HTTP/1.1 404 Nicht gefunden
Datum: Do, 06. Feb 2020 12:46:58 GMT
Inhaltstyp: application/json; charset=utf-8
Inhalt-Länge: 95
{
	"error": 404,
	"Nachricht": "Nicht gefunden",
	"status": "fehler",
	"Zeitstempel": "2020-02-06T12:46:58.7669535Z"
}