Modificar un cliente
PATCH /api/v1/customers/{customerId}
Corrige un cliente. Los campos ausentes del cuerpo conservan su valor.
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 | no | |
email | cadena | no | Único dentro de la organización; null lo borra |
phone | cadena | no | |
notes | cadena | no |
Ejemplo
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…"Respuesta
200 OK— el cliente actualizado.
Qué rechaza
422 Unprocessable Entity— un email mal formado, o un email que ya usa otro cliente de la organización.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.
Notas
- Un vínculo con una cuenta de usuario nunca se reescribe. Cambiar el email de una ficha vinculada no la mueve a otra cuenta.