Conectar con un enlace
En algunos portales no podés obtener la credencial de la cuenta de tu cliente por tu cuenta. Es la inmobiliaria la que tiene que hacer el paso, y vos no deberías tener que manejar sus credenciales 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á. Tu cliente autoriza en el portal |
Argenprop (argenpropapi) | Acá. Tu cliente escribe su credencial de integración en nuestra página |
| Cabaprop, MercadoLibre | Conexiones a portales — vos obtenés el token y lo guardás |
Pedir un enlace para un portal que no está en esta lista devuelve 400.
Los dos modos, y qué cambia para vos
La respuesta del enlace trae un campo connectMode que dice cómo se conecta ese portal:
authorize | credentials | |
|---|---|---|
| Portal | Zonaprop | Argenprop |
| Qué hace tu cliente | autoriza en una ventana del portal | escribe su usuario y contraseña del portal en nuestra página |
| Quién ve la credencial | nadie: la pide el portal en su sitio | la escribe en nuestra página; vos no la ves |
Para tu integración no cambia nada: pedís el enlace igual, lo mandás igual y consultás el estado igual. La página se adapta sola al portal. El campo está documentado porque te sirve para saber qué va a ver tu cliente.
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 enlace apunta a una inmobiliaria, y su identidad sale de la ficha — nunca de lo que mande tu aplicación.
Cómo queda identificada ante el portal depende del portal: en Zonaprop el código lo asignamos nosotros al crear la ficha (MAPAPROP-PA-000123), y tu cliente no necesita tener nada previo más que su cuenta; en Argenprop el identificador lo emite el portal y lo leemos al conectar.
Ver Clientes.
1. Pedir el enlace
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
portal | string | sí | zonapropapi o argenpropapi |
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 qué está por hacer.
En los dos modos la conexión se da por hecha sólo cuando el portal lo confirma. En authorize le preguntamos al portal si la autorización quedó registrada; en credentials hacemos el login contra el portal y leemos el perfil de la cuenta. No alcanza con que la pantalla diga que salió bien.
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} | depende del portal (ver abajo) |
status: "active" → mostrá Desconectar. revoked o 404 → mostrá Conectar.
Qué hace el desconectar, exactamente
Desconectar son dos cosas, y pasan en este orden: primero el portal, después nosotros.
- Cerramos el permiso del lado del portal. La respuesta te lo dice en
remoteUnlink:"ok"quedó cerrado ·"pending"no pudimos y conviene reintentar ·"skipped"ese portal no necesita el paso. - Revocamos la conexión de nuestro lado, y esto pasa siempre — incluso si el paso 1 falló. Que el portal no responda no te deja atado a una integración que pediste terminar.
| Portal | ¿Consume cupo de tu cliente? |
|---|---|
| Zonaprop | sí, 1 — es una ruta por inmobiliaria |
| Argenprop | no — su límite es por integración, no por cuenta |
Lo que NO hace, en ningún caso: dar de baja los avisos. Los avisos los publicó tu cliente con
su cuenta del portal y siguen publicados. La respuesta lo dice explícito en
externalListingsUntouched: true. Si querés bajarlos, hay que despublicarlos antes de desconectar.
Si recibís remoteUnlink: "pending", volvé a llamar al DELETE: es idempotente y reintenta el
paso del portal. En Argenprop ese reintento va a seguir dando pending —una vez revocada la
conexión ya no tenemos la credencial para cerrar la sesión— así que lo que importa es el resultado
del primer llamado.
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 | Usá zonapropapi o argenpropapi |
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 |
409 portal_account_already_connected | Esa cuenta del portal ya está conectada con otra integración | Hay que desconectarla desde donde está conectada hoy. Una cuenta de portal tiene un solo dueño |
Los demás los resuelve tu cliente en la página y no llegan a tu aplicación.
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 y le explica qué está por hacer.
Si termina correctamente, le avisa que puede cerrar. Si algo falla, se lo decimos con el motivo del portal y le dejamos volver a intentar.
En ningún caso la credencial del portal pasa por tu aplicación. Según el portal:
- En Zonaprop tu cliente la escribe en el sitio del portal, en su propia ventana: no la vemos ni nosotros.
- En Argenprop la escribe en nuestra página, porque el portal no tiene una pantalla de autorización: conectarse es iniciar sesión. La usamos una sola vez para que el portal nos autorice, guardamos el permiso que nos devuelve y no guardamos la contraseña.
Argenprop entrega credenciales de integración aparte de las que la inmobiliaria usa para entrar al sitio, con el formato xxxx@api.com. Si tu cliente conecta con las del sitio, la conexión se registra pero las publicaciones fallan por permisos. La página se lo advierte; si lo ves reportado, revisá con qué usuario conectó.
Ese correo trae además un número, que Argenprop llama IdAnunciante y también IdVendedor: son el mismo dato. La página lo pide con los dos nombres, así que tu cliente lo va a reconocer.
Argenprop puede dar de baja los avisos que tu cliente tenía publicados por otro medio. Si venía usando el panel del portal u otro CRM, el portal retira esos avisos cuando la cuenta pasa a gestionarse desde un sistema nuevo, para que no queden duplicados al republicar. Lo hace Argenprop, no nosotros ni tu integración.
Avisale antes de conectar, y tené previsto republicar su cartera desde tu sistema. Más detalle: Argenprop.