Guía de integración de Housing Market API
Las tablas de referencia, las descripciones de los puntos de conexión, los códigos de error y los ejemplos se generan a partir de la especificación de la API y se mantienen en inglés en todos los idiomas. Los nombres, parámetros y códigos son idénticos en todas partes.
Paginación
Todos los puntos de conexión de listas usan cursores. Una respuesta incluye data, next_cursor y has_more.
Pase el next_cursor de una respuesta como cursor de la siguiente solicitud y deténgase cuando has_more sea false.
No hay total ni números de página. Es intencionado: la API está pensada para consultar anuncios, no para copiar la base de datos.
El parámetro limit define el tamaño de página. Su valor predeterminado es 50 y no puede superar 100.
Un cursor es opaco. No lo analice, no lo construya ni lo guarde para más tarde. Está vinculado a su clave y a los filtros de la solicitud que lo generó, y uno no válido se rechaza con invalid_cursor.
Los resultados llegan en un orden estable dentro de un mismo recorrido, pero ese orden no tiene ningún significado. No dependa de él.
Response shape
| Field | Type | Description |
|---|---|---|
data required | array | The items on this page. |
next_cursor required | string | null | Pass as cursor to get the next page. Null on the last page. |
has_more required | boolean | False when there is no further page. |
Request parameters
| Parameter | Type | Required | Values | Description |
|---|---|---|---|---|
limit | integer | no | default 50min 1max 100 | Page size. At most the maximum shown; larger values are refused with invalid_parameter. |
cursor | string | no | The next_cursor of the previous page. Opaque: do not parse it, store
it, or build one. It is bound to your key and to the filters of the
request that produced it, and a cursor used with different filters is
refused with invalid_cursor. |