Housing Market API entegrasyon kılavuzu
Referans tabloları, uç nokta açıklamaları, hata kodları ve örnekler API spesifikasyonundan oluşturulur ve her dilde İngilizce kalır. Adlar, parametreler ve kodlar her yerde aynıdır.
Sayfalama
Tüm liste uç noktaları imleç kullanır. Bir yanıt data, next_cursor ve has_more içerir.
Bir yanıttaki next_cursor değerini sonraki isteğin cursor değeri olarak iletin ve has_more değeri false olduğunda durun.
Toplam sayı ve sayfa numarası yoktur. Bu bilinçli bir tasarım tercihidir: API, veritabanını kopyalamak için değil, ilanları sorgulamak için tasarlanmıştır.
limit parametresi sayfa boyutunu belirler. Varsayılan değeri 50 olup 100 değerini aşamaz.
İmleç opak bir değerdir. Onu ayrıştırmayın, kendiniz oluşturmayın veya sonra kullanmak için saklamayın. İmleç, anahtarınıza ve onu üreten isteğin filtrelerine bağlıdır; geçersiz bir imleç invalid_cursor ile reddedilir.
Sonuçlar tek bir gezinme içinde sabit bir sırayla gelir, ancak bu sıranın bir anlamı yoktur. Bu sıraya güvenmeyin.
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. |