El detalle de una propiedad por su propertyId, con exactamente la misma forma que GET /api/action/express-v1/properties/{propertyHash}.
Existe por una razón concreta: properties/sitemap devuelve el propertyId y no el hash, así que éste es el servicio que te permite abrir la ficha de una propiedad que un visitante encontró por el sitemap.
| Información del recurso | |
|---|---|
| Autenticación | Requerida (Token de API, Bearer) |
| Scope | express-base |
| HTTP Method | GET |
| Response | JSON |
| Version | 1 |
URL del recurso
https://mapaprop.app/api/action/express-v1/properties/id/{propertyId}
Parámetros
| Key | Type | Required | Descripción |
|---|---|---|---|
| propertyId | integer | yes | El id de la propiedad, en la URL. Tiene que ser un entero mayor que 0 |
Código de ejemplo
GET /api/action/express-v1/properties/id/257007 HTTP/1.1
Host: mapaprop.app
Authorization: Bearer {access_token}
Respuesta
La misma que la lectura por hash: el objeto de la propiedad, con sus attributes filtrados, sus videos, su sucursal y el tipo y la operación con su descripción. Como esa lectura, registra una visita a la propiedad.
| Caso | Respuesta |
|---|---|
| La propiedad existe y es de tu cuenta | 200 con el objeto de la propiedad |
| No existe, o no es de tu cuenta | 404 con {"success": false, "message": "Property not found"} |
| El id no es un entero mayor que 0 | 400 con INVALID_INPUT o INVALID_NUMBER |
Ejemplo de respuesta de error
{
"success": false,
"message": "Property not found"
}
Las propiedades sin publicar no se devuelven, igual que en el resto de los servicios de lectura.