Atualizar um cliente
PUT /property-v1/customers
Muda os dados da ficha. É a razão pela qual a ficha existe: mudar um telefone é esta chamada e nada mais, em vez de recadastrar o inventário.
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" }'
Aceita os mesmos campos que o POST e devolve 200
com a ficha atualizada.
O PUT declara como a ficha fica por completo, não faz merge campo por campo: o que você não
enviar fica vazio. Se quiser mudar só o telefone, envie também o resto dos dados.
O customerId não é tocado. É a única coisa que faz com que mudar um telefone não obrigue a
recriar nada.
A mudança alcança os imóveis NOVOS
Cada imóvel guarda o contato com que foi criado: é o registro de como foi publicado, então não é reescrito — nem reenviando o imóvel.
Ou seja: a ficha evita que você repita o bloco em cada cadastro, e o que já cadastrou conserva seus dados.
Se você precisar que uma mudança de contato alcance o inventário já cadastrado, escreva para dev@mapaprop.com: hoje não há como fazer isso pela API.
Um cliente com baixa não é atualizado
Se o cliente está com baixa, o PUT responde 404 com
error: customer_deleted. Primeiro ele é reativado com o POST
— que além disso aplica os dados que você enviar — e depois é atualizado, se for preciso.
É de propósito: um PUT que o atualizasse deixaria uma ficha com baixa e dados novos, o que não
significa nada.
Códigos de resposta
| Código | O que aconteceu | O que fazer |
|---|---|---|
200 | A ficha atualizada | — |
400 | Falta name, country não é um inteiro positivo, branch não é um objeto, ou um texto passa de 256 caracteres | O campo vem em field |
401 | Token ausente ou inválido | — |
403 | O seu token não tem o scope property-api-update | Escreva para nós para habilitá-lo |
404 | Não existe, ou está com baixa (error: customer_deleted) | Veja GET |