Obtener Inmueble
GEThttps://{environment}.metrocuadrado.com/rest-api/realestate/{propertyId}
Obtiene los detalles completos de un inmueble específico.
Ambientes Disponibles
| Ambiente | URL |
|---|---|
| Desarrollo | https://ptec-core-dev.metrocuadrado.com/rest-api/realestate/{propertyId} |
| Producción | https://www.metrocuadrado.com/rest-api/realestate/{propertyId} |
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
- 404 Not Found
- 401 Unauthorized
curl -X GET \
'https://ptec-core-dev.metrocuadrado.com/rest-api/realestate/12345' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'token: tu-jwt-token'
{
"data": {
"id": 12345,
"title": "Apartamento en Zona Rosa",
"description": "Hermoso apartamento con vista panorámica",
"price": 350000000,
"area": 85,
"bedrooms": 2,
"bathrooms": 2,
"city": "Bogotá",
"address": "Calle 85 #15-20",
"amenities": ["Piscina", "Gimnasio", "Parqueadero"],
"status": "active",
"agent": {
"name": "Juan Pérez",
"phone": "3001234567"
}
}
}
{
"error": "Inmueble no encontrado"
}
{
"error": "API Key inválida o faltante"
}
Notas Importantes
- Requiere un token JWT válido (generar en el endpoint de autenticación)
- La API Key debe corresponder al ambiente seleccionado
- El ID del inmueble debe existir en el sistema
- Incluye información detallada del inmueble y agente asignado
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 - Incluye el ID del inmueble en la URL
- Realiza la petición GET al endpoint correspondiente
Códigos de Respuesta
| Código | Descripción |
|---|---|
| 200 | Detalles del inmueble obtenidos |
| 401 | API Key inválida o faltante |
Probar Endpoint
API Tester
Prueba los endpoints de forma interactiva