Panduan integrasi Housing Market API

Tabel referensi, deskripsi endpoint, kode kesalahan, dan contoh dihasilkan dari spesifikasi API dan tetap dalam bahasa Inggris di setiap bahasa. Nama, parameter, dan kode sama di semua tempat.

Mendapatkan kunci

Anda mendapatkan kunci dengan berlangganan di konsol. Tidak ada antrean persetujuan dan tidak perlu mengirim email.

  1. Masuk ke konsol, atau buat akun. Akun ini sama dengan akun yang Anda gunakan untuk produk Housing Market lainnya.
  2. Pilih negara, satu kawasan atau seluruh dunia, paket, serta penagihan bulanan atau tahunan.
  3. Masukkan alamat IP yang akan digunakan server Anda untuk memanggil API.
  4. Setujui ketentuan penggunaan API. Kami menyimpan catatan tentang apa yang Anda setujui dan kapan.
  5. Lakukan pembayaran. Kunci Anda baru muncul setelah pembayaran berhasil, dan hanya ditampilkan sekali.

Salin kunci langsung ke penyimpanan rahasia Anda. Kami hanya menyimpan hash satu arahnya, sehingga kami tidak dapat menampilkannya lagi kepada Anda. Bentuk kunci seperti hma_<prefix>_<secret>.

Anda dapat membuat kunci pengganti di konsol kapan saja. Kunci lama tetap berfungsi selama 24 jam setelahnya, sehingga Anda dapat beralih tanpa waktu henti.

Status kunci

  • Aktif: kunci berfungsi.
  • Dijeda: kunci ditolak dengan key_paused. Kunci akan aktif kembali dengan sendirinya setelah penyebabnya teratasi.
  • Dicabut: kunci ditolak secara permanen dengan unauthenticated.

Jika pembayaran perpanjangan gagal, kunci Anda tetap berfungsi selama masa tenggang 5 hari sementara kami mengirimi Anda email di setiap tahap, lalu kunci dijeda. Kunci yang dijeda akan aktif kembali secara otomatis segera setelah pembayaran diselesaikan. Sengketa pembayaran langsung menjeda kunci hingga sengketa tersebut selesai ditinjau.

Penambahan negara atau peningkatan paket langsung ditagih secara prorata, dan berlaku pada kunci yang sama sesaat setelah pembayaran dikonfirmasi. Pengurangan negara atau penurunan paket berlaku pada perpanjangan berikutnya.