BETA

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étodoRutaQuién lo llama
POST/property-v1/connect-linksVos, con tu token
GET/property-v1/connect-links/{token}La página que ve tu cliente
POST/property-v1/connect-links/{token}/confirmLa 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

PortalCó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, MercadoLibreConexiones 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:

authorizecredentials
PortalZonapropArgenprop
Qué hace tu clienteautoriza en una ventana del portalescribe su usuario y contraseña del portal en nuestra página
Quién ve la credencialnadie: la pide el portal en su sitiola 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

CampoTipoRequeridoDescripción
portalstringsízonapropapi o argenpropapi
clientRefstringsí*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:

PasoLlamada¿Consume cupo del portal?
Decidir qué botón mostrarGET /connections/{portal}no
Click en ConectarPOST /property-v1/connect-links → abrí la urlno
Tu cliente autoriza—sí, 1
Click en DesconectarDELETE /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.

  1. 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.
  2. 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?
Zonapropsí, 1 — es una ruta por inmobiliaria
Argenpropno — 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ódigoCuándoQué hacer
400El portal no admite este flujoUsá zonapropapi o argenpropapi
409No declaraste la ficha del clienteCreala con POST /property-v1/customers
404El enlace no existeRevisá que esté completo
410El enlace venció (7 días)Pedí uno nuevo
409 not_authorized_yetTu cliente todavía no completó la autorizaciónQue termine el paso en el portal
409 portal_account_already_connectedEsa cuenta del portal ya está conectada con otra integraciónHay 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.