Lister les clients
GET /api/v1/customers
Le carnet d’adresses de l’organisation de la clé.
Autorisation
| Rôle dans l’organisation | Cet endpoint |
|---|---|
owner | Autorisé |
admin | Autorisé |
member | Autorisé |
Paramètres de requête
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
page | entier | 1 | Numéro de page, à partir de 1 |
limit | entier | 20 | Taille de page, plafonnée à 100 |
search | chaîne | — | Cherche à la fois dans le nom, l’email et le téléphone |
Exemple
bash
curl -H "x-api-key: $VILLASLOT_API_KEY" \
"https://villaslot.app/api/v1/customers?search=lindqvist"Réponse
200 OK— la page, avecpagination.
Ce qu’il refuse
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é.