Créer un client
POST /api/v1/customers
Crée un client dans l’organisation de la clé. L’id renvoyé ici est le customerId dont une
réservation a besoin.
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 | oui | Le nom du client |
email | chaîne | non | Unique au sein de l’organisation quand il est présent |
phone | chaîne | non | |
notes | chaîne | non | Texte libre pour l’équipe |
Exemple
bash
curl -X POST -H "x-api-key: $VILLASLOT_API_KEY" -H "content-type: application/json" \
-d '{"name":"Tomas Lindqvist","email":"tomas@example.com"}' \
"https://villaslot.app/api/v1/customers"Réponse
201 Created— le client créé.
Ce qu’il refuse
409 Conflict— la limite de clients de l’offre est atteinte.422 Unprocessable Entity— le nom est absent, l’email est mal formé, ou un autre client de l’organisation porte déjà cet email. Cherchez d’abord et réutilisez l’identifiant existant.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é.