Listar los clientes
GET /api/v1/customers
La agenda de la organización de la clave.
Autorización
| Rol en la organización | Este endpoint |
|---|---|
owner | Permitido |
admin | Permitido |
member | Permitido |
Parámetros de consulta
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
page | entero | 1 | Número de página, desde 1 |
limit | entero | 20 | Tamaño de página, máximo 100 |
search | cadena | — | Busca a la vez en el nombre, el email y el teléfono |
Ejemplo
bash
curl -H "x-api-key: $VILLASLOT_API_KEY" \
"https://villaslot.app/api/v1/customers?search=lindqvist"Respuesta
200 OK— la página, conpagination.
Qué rechaza
401 Unauthorized— clave ausente o no válida, o clave cuyo portador ha dejado la organización.404 Not Found— identificador desconocido, o identificador que pertenece a otra organización. Los dos son deliberadamente indistinguibles.429 Too Many Requests— más de 120 peticiones en un minuto para esta clave.