Élément de patch #

Met à jour un ensemble spécifique de propriétés d'un élément de répertoire. Cela utilise le JSON Format de correctif pour toute modification.

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

Exemple #

Cette demande ajoutera un nouveau champ de téléphone à un élément d'annuaire existant.

Demande #

PATCH <https://api.eu.myreports.cloud/api/v1.0/contactdirectories/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000123> HTTP/1.1
Content-Type : application/json
Frais d'acceptation : Vrai
Authorization : Bearer {TOKEN}
Connexion : keep-alive
{
    « path » : « /fields/phone2 »,
    « op » : « add »,
    « value » : « +44YYYYYYYYYYY »
}

Réponse #

HTTP/1.1 201 Créé
Type de contenu : application/json; Charset=UTF-8
Contenu - Longueur : xx
Emplacement : <https://api.eu.myreports.cloud/api/v1.0/contactdirectories/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000123>
{
	« data » : {
        « id » : « 00000000-0000-0000-0000-00000000123 »,
        « fields » : {
            « titre » : « M. »,
            « fullName » : « CRM3a »,
            « companyName » : « Company »,
            « Titre du poste » : « Titre du poste »,
            « phone1 » : « +44XXXXXXXXXX »,
            « phone2 » : « +44YYYYYYYYYYY »,
            « courriel » : « Adresse courriel »,
            « champ1 » : « champ1 »,
            « champ2 » : « champ2 »,
            « crmId » : « 00000000-0000-0000-00000-00000000001 »
        }
    },
	« statut » : « succès »,
	« timestamp » : « 2019-11-29T16:03:23.9251680Z »
}

Erreurs #

Non autorisé #

Lorsque le jeton n'est pas fourni, non valide ou expiré

HTTP/1.1 401 Non autorisé

Mauvaise demande #

Lorsque l'ID d'élément de répertoire fourni n'est pas au format correct

HTTP/1.1 400 Mauvaise demande
Date : Jeu, 06 Février 2020 12:45:27 GMT
Type de contenu : application/json ; charset=utf-8
Durée du contenu : 149
{
	« erreur » : 400,
	« message » : « La valeur '<tenant id>' n'est pas valide.",
	« statut » : « erreur »,
	« horodatage » : « 2020-02-06T12:45:27.5903465Z »
}

Introuvable #

Lorsqu'il n'y a pas d'éléments de répertoire qui ont un ID correspondant

HTTP/1.1 404 Introuvable
Date : Jeu, 06 Février 2020 12:46:58 GMT
Type de contenu : application/json ; charset=utf-8
Durée du contenu : 95
{
	« erreur » : 404,
	« message » : « Introuvable »,
	« statut » : « erreur »,
	« horodatage » : « 2020-02-06T12:46:58.7669535Z »
}