Actualizar un cliente
PUT /property-v1/customers
Cambia los datos de la ficha. Es la razón por la que la ficha existe: cambiar un teléfono es esta llamada y nada más, en vez de recargar el inventario.
curl -X PUT https://property-api.mapaprop.com/property-v1/customers \
-H "Authorization: Bearer $TOKEN" \
-H "x-client-ref: cliente-42" \
-H "Content-Type: application/json" \
-d '{ "name": "Inmobiliaria Modelo", "phone1": "2239999999" }'
Acepta los mismos campos que el POST y devuelve
200 con la ficha actualizada.
El PUT declara cómo queda la ficha completa, no hace merge campo por campo: lo que no mandes
queda vacío. Si querés cambiar sólo el teléfono, mandá también el resto de los datos.
El customerId no se toca. Es lo único que hace que cambiar un teléfono no obligue a recrear nada.
El cambio alcanza a las propiedades NUEVAS
Cada propiedad guarda el contacto con el que se dio de alta: es el registro de cómo se publicó, así que no se reescribe — ni mandando la propiedad de nuevo.
O sea: la ficha te ahorra repetir el bloque en cada alta, y lo que ya cargaste conserva sus datos.
Si necesitás que un cambio de contacto alcance al inventario ya cargado, escribinos a dev@mapaprop.com: hoy no hay forma de hacerlo por API.
Un cliente dado de baja no se actualiza
Si el cliente está dado de baja, el PUT responde 404 con
error: customer_deleted. Primero se reactiva con el POST
—que además aplica los datos que le mandes— y después se actualiza si hace falta.
Es a propósito: un PUT que lo actualizara dejaría una ficha dada de baja con datos nuevos, que no
significa nada.
Códigos de respuesta
| Código | Qué pasó | Qué hacer |
|---|---|---|
200 | La ficha actualizada | — |
400 | Falta name, country no es un entero positivo, branch no es un objeto, o un texto pasa de 256 caracteres | El campo viene en field |
401 | Token ausente o inválido | — |
403 | Tu token no tiene el scope property-api-update | Escribinos para habilitarlo |
404 | No existe, o está dado de baja (error: customer_deleted) | Ver GET |