Mapaprop

Primeros pasos con la Portal API

Construí tu propio portal usando la Portal API de Mapaprop para buscar en el inventario inmobiliario de los clientes.

1. Obtené tu access token

Registrá tu aplicación en Primeros pasos.

2. Flujo básico

Un portal se arma en cinco pasos. Los tres primeros son el buscador; los dos últimos, la ficha.

1 · Traé los catálogos del país, una vez

settings/types/{country}, settings/operations/{country} y settings/currencies/{country} son el catálogo del país: cambian muy poco. Traelos al arrancar y cacheálos — no los pidas en cada búsqueda.

2 · Resolvé la zona que el visitante escribe

zones/suggestions convierte texto libre en un código de zona. Es lo que alimenta el autocompletado del buscador, y el code que devuelve es el que después se usa para filtrar.

3 · Buscá

properties/{country} con los filtros armados en los dos pasos anteriores. Devuelve total para paginar y la lista de propiedades.

4 · Mostrá la ficha

properties/{propertyHash} trae la propiedad completa. Registrá la visita con PUT properties/{propertyHash}/hits: es lo que le permite a la inmobiliaria ver que su aviso se está viendo en tu portal.

Si es un desarrollo (development: true), la ficha trae además su grupo de campos y la lista de ids de sus unidades en developmentProperties. Para mostrarlas, pedilas con development/properties.

development/properties no resuelve "las unidades de X": filtra por los ids que le mandás. Si le pasás el id del desarrollo en vez de los de developmentProperties, te devuelve el desarrollo mismo — y nada en la respuesta avisa que eso pasó. La sección de unidades termina mostrando al proyecto como su propia única unidad.

5 · Recibí la consulta

POST messages envía la consulta del visitante a la inmobiliaria. Pide userAgent, referer e ip reales del navegador: son la verificación anti-spam, y mandarlos inventados hace que la consulta quede retenida.

Lo opcional, según qué portal armes

3. Servicios disponibles

GET /api/action/portal-v2/settings/operations/{country}

GET /api/action/portal-v2/settings/types/{country}

GET /api/action/portal-v2/settings/currencies/{country}

GET /api/action/portal-v2/zones/suggestions

GET /api/action/portal-v2/properties/{country}/

POST /api/action/portal-v2/sitemap/search-url/{country}

GET /api/action/portal-v2/properties/{propertyHash}

GET /api/action/portal-v2/development/properties

PUT /api/action/portal-v2/properties/{propertyHash}/hits

POST /api/action/portal-v2/messages

GET /api/action/portal-v2/customers

GET /api/action/portal-v2/branches

GET /api/action/portal-v2/branches/{seoUrl}/properties

GET /api/action/portal-v2/featureds

GET /api/action/portal-v2/properties/{propertyHash}/share-branch/{branchSeoUrl}