Conectar con un enlace
Algunos portales no te entregan una credencial de la cuenta de tu cliente. La inmobiliaria tiene que entrar al portal y autorizar ella misma, y la autorización queda guardada del lado del portal.
Para esos casos pedís un enlace de conexión, se lo mandás a tu cliente, y él completa el paso en una página nuestra. Cuando termina, la conexión queda registrada y podés publicar en su nombre.
| Método | Ruta | Quién lo llama |
|---|---|---|
POST | /property-v1/connect-links | Vos, con tu token |
GET | /property-v1/connect-links/{token} | La página que ve tu cliente |
POST | /property-v1/connect-links/{token}/confirm | La página que ve tu cliente |
Los dos últimos son públicos: los usa la página, no tu aplicación. Están documentados para que entiendas el flujo, no para que los llames.
Estos endpoints están en desarrollo. Escribinos a dev@mapaprop.com si tu integración los necesita.
Cuándo usar este camino y cuándo no
| Portal | Cómo conectar |
|---|---|
Zonaprop (zonapropapi) | Acá. No emite credencial por cuenta |
| Argenprop, Cabaprop, MercadoLibre | Conexiones a portales — vos obtenés el token y lo guardás |
Hoy sólo Zonaprop usa este flujo. Pedir un enlace para otro portal devuelve 400.
Antes de empezar: declarar a tu cliente
El enlace se emite para una ficha de cliente ya declarada. Si no la creaste, recibís 409.
Es así porque el código con el que tu cliente se identifica ante el portal lo asignamos nosotros al crear la ficha (MAPAPROP-PA-000123). Tu cliente no necesita tener nada previo en el portal más que su cuenta.
Ver Clientes.
1. Pedir el enlace
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
portal | string | sí | Hoy sólo zonapropapi |
clientRef | string | sí* | Tu id de cliente. *Se puede mandar por header x-client-ref |
curl -X POST https://property-api.mapaprop.com/property-v1/connect-links \
-H "Authorization: Bearer <TU_TOKEN>" \
-H "x-client-ref: cliente-42" \
-H "Content-Type: application/json" \
-d '{ "portal": "zonapropapi" }'
Respuesta 201:
{
"token": "x-_qM7tYl3TnjxIyxTCmX2Y6dfuD1uiSYO8VX3M3jZE",
"portal": "zonapropapi",
"expiresAt": "2026-10-08T17:51:44.000Z",
"url": "https://www.mapaprop.com/property-api/connect/zonapropapi/x-_qM7tYl3Tnjx..."
}
Usá la url tal como viene. No la armes vos: si movemos la página, los enlaces que ya mandaste se romperían.
El enlace vale una sola vez y dura 7 días. Cuando tu cliente completa la conexión, el enlace queda consumido. Para reconectar —por ejemplo si se desconectó— pedí uno nuevo.
Requiere el scope property-api-create.
2. Mandáselo a tu cliente
Por mail, por tu panel, como prefieras. La página le muestra el nombre de su inmobiliaria para que verifique que está conectando la cuenta correcta, y le explica que va a entrar con sus credenciales del portal — no con las de Mapaprop.
Lo que pasa ahí: tu cliente autoriza en el portal, y la página le pregunta al portal si la autorización quedó registrada antes de dar la conexión por hecha. No alcanza con que el portal diga que sí en pantalla.
3. Enterarte de que terminó
No te avisamos. Cuando tu cliente completa el paso, consultá el estado:
curl https://property-api.mapaprop.com/connections/zonapropapi \
-H "Authorization: Bearer <TU_TOKEN>" \
-H "x-client-ref: cliente-42"
status: "active" significa conectado. Esa llamada no consume cupo del portal: lee nuestro registro.
El botón de tu aplicación
Con esto podés dibujar un solo botón que sirva para conectar y para desconectar:
| Paso | Llamada | ¿Consume cupo del portal? |
|---|---|---|
| Decidir qué botón mostrar | GET /connections/{portal} | no |
| Click en Conectar | POST /property-v1/connect-links → abrí la url | no |
| Tu cliente autoriza | — | sí, 1 |
| Click en Desconectar | DELETE /connections/{portal} | sí, 1 |
status: "active" → mostrá Desconectar. revoked o 404 → mostrá Conectar.
Mirá status, no si la conexión existe. GET /connections devuelve también las conexiones revocadas: conservamos el registro para poder reconectar. Si tu código hace if (connections.length > 0) va a dar por conectado a un cliente que se desconectó.
Pedí el enlace cuando tu cliente aprieta el botón, no al dibujarlo. Si lo pedís en cada carga de pantalla, generás enlaces que nadie usa.
En Zonaprop, además: cupo mensual y límites.
Respuestas de error
| Código | Cuándo | Qué hacer |
|---|---|---|
400 | El portal no admite este flujo | Hoy sólo zonapropapi |
409 | No declaraste la ficha del cliente | Creala con POST /property-v1/customers |
404 | El enlace no existe | Revisá que esté completo |
410 | El enlace venció (7 días) | Pedí uno nuevo |
409 not_authorized_yet | Tu cliente todavía no completó la autorización | Que termine el paso en el portal |
Qué ve tu cliente
La página es nuestra, no lleva tu marca ni la de Mapaprop más allá de un pie, y no tiene navegación: no lo invita a irse a ningún lado. Le muestra el nombre de su inmobiliaria, le explica qué está autorizando, y abre la ventana del portal.
Si termina correctamente, le avisa que puede cerrar. Si el portal todavía no registró la autorización, se lo dice y le deja volver a intentar.
No le pedimos sus credenciales del portal en ningún momento: las pone en el sitio del portal, en su propia ventana.