DEVELOPING

Quando algo não sai

A ordem abaixo não é arbitrária: vai do gratuito ao caro e do que você pode ver ao que nós temos que olhar. Os dois primeiros passos resolvem a maioria dos casos e não gastam nada da cota do seu cliente.

A ordem

1 · leia o erro completo                gratuito — e quase sempre diz qual passo falta
2 · verifique o objeto                  gratuito — POST /properties/verify
3 · leia o que temos guardado           gratuito — GET /properties/{paId}
4 · pergunte ao portal                  custa 1 chamada
5 · escreva para nós                    com a referência do passo 1

1 · O erro completo, não só o código

Os nossos erros estão escritos para que digam o que fazer, não só que algo falhou. Além do código eles trazem uma descrição e, quando for o caso, o nome do campo ou do portal.

O mais importante: um erro nosso diz se o problema é seu (algo no que você mandou) ou do passo anterior (falta a ficha, falta a conexão). Se disser que falta conectar a conta, não é um problema de permissões do seu token.

2 · Verificar o objeto (gratuito)

POST /properties/verify com o mesmo objeto que falhou. Ele diz, portal por portal, o que falta. Não pergunta nada ao portal, então não gasta cota nem depende de o portal estar no ar.

Separa duas coisas que convém não misturar:

O que falta no objeto → está sob o seu controle.
O que falta da conta (o plano, a filial) → sai da conexão, não do imóvel.

O que você vê	Por onde começar
"Publiquei e não vejo o anúncio"	O portal pode demorar para mostrá-lo. O passo 4 diz se ele já o tem; se disser que sim, é tempo de publicação do portal, não um problema da integração
O plano que pedi não está disponível	A resposta do publish diz quais o seu cliente tem. Se você não esperava isso, atualize os planos contra o portal: algum pode ter sido consumido ou vencido
Um `403`	Olhe qual scope ele diz que falta. Se nomear um portal, o seu token não está habilitado para aquele portal — o que é diferente de não poder ler ou escrever
Diz que a conta não está conectada	Peça a ficha do cliente (gratuito) e olhe o estado das conexões dele. Pode ser que o seu cliente a tenha desconectado do lado do portal
Uma lista de consultas vazia	Antes de supor que não há, confira que modo aquele portal suporta: pode ser que ali as consultas não sejam pedidas, e sim que cheguem sozinhas
Um dado que você mandou não aparece	Verifique (passo 2): se o portal não suportar aquele campo, dizemos isso ali em vez de descartá-lo em silêncio

O que convém descartar antes de nos escrever

Você verificou o objeto? É gratuito e responde a maioria.
O erro nomeia um passo anterior (ficha, conexão)? Então o problema não está onde você está olhando.
Você está usando o identificador que devolvemos, e não um seu, onde a rota pede o nosso?
O portal suporta isso? Não todos suportam tudo, e o que não, dizemos sem gastar cota.

5 · Escreva para nós

dev@mapaprop.com. O que mais acelera a resposta:

A referência que veio no erro. Com ela encontramos a sua chamada exata nos nossos registros — é a diferença entre olhar o caso e pedir que você o reproduza.
O que você esperava e o que aconteceu, nessa ordem.
O clientRef e o identificador do imóvel.

Não nos mande o seu token nem a credencial do seu cliente. Não precisamos deles para diagnosticar, e se você os mandou por engano, avise para que possamos ajudá-lo a rotacioná-los.

Relacionado

Boas práticas — os fluxos completos
Verificar — o passo 2, o mais rentável
Publicação — o que cada portal suporta

Quando algo não sai

A ordem

1 · O erro completo, não só o código

2 · Verificar o objeto (gratuito)

3 · O que temos guardado (gratuito)

4 · Perguntar ao portal (1 chamada)

Os casos que aparecem mais

O que convém descartar antes de nos escrever

5 · Escreva para nós

Relacionado