POST /cabaprop/connect
Este servicio conecta una cuenta con Cabaprop a partir de la API KEY que el titular de la cuenta genera desde su panel en cabaprop.com.ar. Devuelve un token propio de Cabaprop que hay que reenviar en el header X-Cabaprop-Token en el resto de los endpoints de la cuenta (GET /cabaprop/get-branches, POST /cabaprop/publish, PUT /cabaprop/property, DELETE /cabaprop/property/unpublish).
El token de Cabaprop expira (aproximadamente 30 días). Guardalo junto con su exp y volvé a llamar a este endpoint con la misma apiKey cuando esté vencido o por vencer.
| Información del recurso | |
|---|---|
| Autenticación | Requerida (token de Mapaprop) |
| Método HTTP | POST |
| Respuesta | JSON |
| Versión | 1 |
Resource URL
https://property-api.mapaprop.com/cabaprop/connect
Headers
| Header | Requerido | Descripción |
|---|---|---|
Authorization | sí | Bearer <token> — token de Mapaprop (ver Getting Started) |
Content-Type | sí | application/json |
Parameters (body request)
| Key | Tipo | Requerido | Descripción |
|---|---|---|---|
apiKey | string | sí | API KEY generada por el cliente en su panel de Cabaprop. Nunca se persiste tal cual en la respuesta ni se reenvía en texto plano en llamadas posteriores. |
Sample code
POST /cabaprop/connect
Host: property-api.mapaprop.com
Content-Type: application/json
Authorization: Bearer {access_token}
{
"apiKey": "tu-api-key-de-cabaprop"
}
Response
En caso de éxito devuelve un 200 con el token de Cabaprop y su expiración decodificada:
{
"token": "{cabaprop_token}",
"exp": 1735689600
}
| Campo | Tipo | Descripción |
|---|---|---|
token | string | Token JWT propio de Cabaprop. Reenviarlo como header X-Cabaprop-Token en el resto de los endpoints de la cuenta. |
exp | number | null | Timestamp Unix (segundos) de expiración del token, decodificado del JWT. null si no se pudo decodificar. |
Errores
| Status | Cuerpo | Causa |
|---|---|---|
| 400 | {"error":"Invalid JSON body"} | El body no es un JSON válido. |
| 400 | {"error":"apiKey is required"} | Falta el campo apiKey en el body. |
| 401 | {"error":"Cabaprop authentication failed"} | Cabaprop rechazó la API KEY (401/403). |
| 502 | {"error":"Cabaprop upstream error: missing token in response"} | Cabaprop respondió con éxito pero sin un token en el body. |
| 500 | {"error":"Error during Cabaprop authentication","detail":"..."} | Error inesperado al contactar a Cabaprop. |