Primeiros passos com OAuth2
Aprenda a conectar seu aplicativo aos webservices do Mapaprop usando o protocolo OAuth2.
Este guia é para portais e terceiros que integram o Mapaprop com registro de aplicativo (Feeds API, Customer API, Network API, Property API). O token é obtido com client_id/client_secret e expira a cada 14 dias.
Se você é cliente Mapaprop e quer usar a Express API (Pro+) ou a Mapaprop Chat AI API (Business), não use este fluxo: ative seu Token de API com um clique a partir da sua conta (Configuração > API Token), sem registrar aplicativo e sem client_secret. Veja API Token.
1. Registre seu aplicativo
Registre seu aplicativo no Mapaprop para obter suas credenciais.
2. Obtenha seu access token
Após o registro do seu aplicativo no Mapaprop você poderá obter um access token. Esse token permite utilizar nossas diferentes APIs. Siga os passos abaixo para obtê-lo.
- POST /api/action/oauth2-v1/authorize (método recomendado)
- Para gerar o token manualmente use nosso app http://mapaprop.github.io
Expiração do token
Os tokens expiram geralmente a cada 14 dias. Sempre que você receber um HTTP 403 é provável que o token tenha expirado e você precisará obter um novo (via authorize ou manualmente em http://mapaprop.github.io)
- Feeds API se você é um portal ou anunciante e quer exibir as propriedades das imobiliárias em seu site.
Download de imagens
Como os custos de transferência de dados são bastante elevados atualmente, todas as imagens devem ser servidas a partir dos seus próprios servidores. Para isso você precisará baixar as imagens dos nossos servidores. Para evitar o uso indevido das imagens, precisamos saber qual user agent você utiliza nas requisições de imagens ou de qual faixa de IPs você acessa. Entre em contato com o Mapaprop para fornecer essa informação. Bloquearemos todo o tráfego anônimo e suspeito. (exemplo de user agent: Empresa/Versão como Mapaprop/1.2.3)
Envie-nos as seguintes informações por e-mail para soporte@mapaprop.com:
- Arquivo de imagem PNG com seu logotipo em fundo transparente no formato quadrado de pelo menos 500px de largura.
- Arquivo de imagem PNG com seu logotipo em fundo transparente no formato retangular de pelo menos 500px de largura.
- Pelo menos uma URL para que possamos verificar as listagens de imóveis do Mapaprop.