Modifier un client
PATCH /api/v1/customers/{customerId}
Corrige un client. Les champs absents du corps gardent leur valeur.
Autorisation
| Rôle dans l’organisation | Cet endpoint |
|---|---|
owner | Autorisé |
admin | Autorisé |
member | Autorisé |
Corps de la requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
name | chaîne | non | |
email | chaîne | non | Unique au sein de l’organisation ; null l’efface |
phone | chaîne | non | |
notes | chaîne | non |
Exemple
bash
curl -X PATCH -H "x-api-key: $VILLASLOT_API_KEY" -H "content-type: application/json" \
-d '{"phone":"+62 812 3456 7890"}' \
"https://villaslot.app/api/v1/customers/8d3e…"Réponse
200 OK— le client mis à jour.
Ce qu’il refuse
422 Unprocessable Entity— un email mal formé, ou un email déjà utilisé par un autre client de l’organisation.401 Unauthorized— clé absente ou invalide, ou clé dont le porteur a quitté l’organisation.404 Not Found— identifiant inconnu, ou identifiant appartenant à une autre organisation. Les deux sont volontairement indiscernables.429 Too Many Requests— plus de 120 requêtes en une minute pour cette clé.
Notes
- Un lien vers un compte utilisateur n’est jamais réécrit. Changer l’email d’une fiche liée ne la déplace pas vers un autre compte.