Panduan integrasi Housing Market API

Jadual rujukan, perihalan titik akhir, kod ralat dan contoh dijana daripada spesifikasi API dan kekal dalam bahasa Inggeris dalam setiap bahasa. Nama, parameter dan kod adalah sama di mana-mana.

Gambaran keseluruhan dan pelan

Housing Market API memberikan perisian anda akses baca sahaja kepada penyenaraian hartanah yang diterbitkan daripada portal Housing Market Group. Cerapan pasaran agregat akan tersedia tidak lama lagi pada pelan Lanjutan.

Setiap permintaan dihantar ke https://api.housingmarketapi.com melalui HTTPS, dan setiap respons adalah dalam JSON. Semua titik akhir adalah baca sahaja: semuanya ialah permintaan GET.

Terdapat dua pelan. Kedua-duanya menggunakan kunci yang sama dan titik akhir yang sama untuk penyenaraian.

  • Standard: penyenaraian yang diterbitkan dengan setiap butiran hartanah yang diterangkan dalam panduan ini, bagi negara yang anda langgani.
  • Lanjutan: semua yang ada dalam Standard, serta titik akhir Insights (volum carian, volum prospek, harga, bilangan hartanah, tahap aktiviti dan data pasaran pihak ketiga) yang akan tersedia tidak lama lagi. Pelanggan Lanjutan mendapat Insights pada kunci yang sama sebaik sahaja ia dilancarkan.

Insights ialah data agregat. Setiap nilai ialah kiraan atau median bagi sesuatu tempat dan tempoh; tiada apa-apa yang menggambarkan seseorang individu, prospek, ejen atau penyenaraian tertentu.

Anda memilih negara semasa melanggan: negara individu, satu rantau atau seluruh dunia. Anda boleh menambah negara atau menaik taraf kemudian, dan kunci yang sama akan meliputinya.

Anda boleh membayar secara bulanan atau tahunan. Konsol menunjukkan dengan tepat jumlah yang akan dicaj sebelum anda mengesahkan, jadi tiada harga dinyatakan dalam panduan ini.

Negara sentiasa ditulis sebagai kod negara ISO, contohnya TH untuk Thailand. Konsol menyenaraikan negara yang diliputi oleh kunci anda.