Inmuebles Publicados/Despublicados
GEThttps://{environment}.metrocuadrado.com/rest-api/realestate?status={Status}
Obtiene el listado de inmuebles filtrados por estado de publicación.
Ambientes Disponibles
| Ambiente | URL |
|---|---|
| Desarrollo | https://ptec-core-dev.metrocuadrado.com/rest-api/realestate?status={Status} |
| Producción | https://www.metrocuadrado.com/rest-api/realestate?status={Status} |
Autenticación
| Header | Valor | Requerido | Descripción |
|---|---|---|---|
| Content-Type | application/json | Sí | Tipo de contenido |
| x-api-key | string | Sí | API key de autenticación |
| token | string | Sí | Token JWT de acceso |
Ejemplos
- Request
- 200 OK
- 401 Unauthorized
# Obtener inmuebles publicados
curl -X GET \
'https://ptec-core-dev.metrocuadrado.com/rest-api/realestate?status=P' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'token: tu-jwt-token'
# Obtener inmuebles despublicados
curl -X GET \
'https://ptec-core-dev.metrocuadrado.com/rest-api/realestate?status=U' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'token: tu-jwt-token'
{
"data": [
{
"id": 1,
"title": "Apartamento en Zona Rosa",
"price": 350000000,
"area": 85,
"bedrooms": 2,
"bathrooms": 2,
"city": "Bogotá",
"status": "active"
}
]
}
{
"error": "Token de autorización inválido o expirado"
}
Notas Importantes
- Requiere un token JWT válido (generar en el endpoint de autenticación)
- La API Key debe corresponder al ambiente seleccionado
- El parámetro status es obligatorio:
- "P": Inmuebles publicados
- "U": Inmuebles despublicados
- Los resultados incluyen todos los inmuebles del estado especificado
Cómo Probar
Para probar este endpoint, sigue estos pasos:
- Genera un token JWT usando el endpoint de autenticación
- Asegúrate de usar la API Key correcta según el ambiente
- Incluye el token en el header
token - Realiza la petición GET al endpoint correspondiente
Códigos de Respuesta
| Código | Descripción |
|---|---|
| 200 | Listado de inmuebles obtenido |
| 401 | Token inválido o expirado |
Probar Endpoint
API Tester
Prueba los endpoints de forma interactiva