Crear un cliente
POST /api/v1/customers
Crea un cliente en la organización de la clave. El id devuelto aquí es el customerId que
necesita una reserva.
Autorización
| Rol en la organización | Este endpoint |
|---|---|
owner | Permitido |
admin | Permitido |
member | Permitido |
Cuerpo de la petición
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
name | cadena | sí | El nombre del cliente |
email | cadena | no | Único dentro de la organización cuando está presente |
phone | cadena | no | |
notes | cadena | no | Texto libre para el equipo |
Ejemplo
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"Respuesta
201 Created— el cliente creado.
Qué rechaza
409 Conflict— se ha alcanzado el límite de clientes del plan.422 Unprocessable Entity— falta el nombre, el email está mal formado, u otro cliente de la organización ya tiene ese email. Busca primero y reutiliza el identificador existente.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.