Buscar Transacción
GEThttps://{environment}.metrocuadrado.com/rest-api/transactions/
Obtiene los detalles de una transacción específica por su ID.
Ambientes Disponibles
| Ambiente | URL Base |
|---|---|
| Desarrollo | https://ptec-core-dev.metrocuadrado.com/rest-api/transactions/ |
| Producción | https://www.metrocuadrado.com/rest-api/transactions/ |
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/transactions/' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'token: tu-jwt-token'
{
"data": {
"id": 12345,
"propertyId": 67890,
"clientName": "Juan Pérez",
"clientEmail": "juan@email.com",
"amount": 350000000,
"status": "completed",
"transactionDate": "2024-01-15T10:30:00Z",
"property": {
"title": "Apartamento en Zona Rosa",
"address": "Calle 85 #15-20"
},
"agent": {
"name": "María García",
"id": 123,
"phone": "3001234567"
}
}
}
{
"error": "Transacción no encontrada"
}
{
"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 ID de la transacción debe existir en el sistema
- Incluye información detallada del inmueble y agente asociados
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 de la transacción en la URL
- Realiza la petición GET al endpoint correspondiente
Códigos de Respuesta
| Código | Descripción |
|---|---|
| 200 | Detalles de la transacción obtenidos |
| 404 | Transacción no encontrada |
| 401 | Token inválido o expirado |
Probar Endpoint
API Tester
Prueba los endpoints de forma interactiva