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.
Mendapatkan kunci
Anda mendapat kunci dengan melanggan dalam konsol. Tiada baris gilir kelulusan dan tiada e-mel yang perlu dihantar.
- Log masuk ke konsol, atau cipta akaun. Ia ialah akaun yang sama yang anda gunakan untuk produk Housing Market yang lain.
- Pilih negara, satu rantau atau seluruh dunia, pelan, dan pengebilan bulanan atau tahunan.
- Masukkan alamat IP yang akan digunakan oleh pelayan anda untuk memanggil API.
- Terima terma penggunaan API. Kami menyimpan rekod tentang apa yang anda terima dan bila.
- Bayar. Kunci anda hanya dipaparkan selepas pembayaran berjaya, dan ia ditunjukkan sekali sahaja.
Salin kunci terus ke dalam stor rahsia anda. Kami hanya menyimpan cincangan sehala kunci tersebut, jadi kami tidak dapat menunjukkannya kepada anda lagi. Kunci kelihatan seperti hma_<prefix>_<secret>.
Anda boleh mencipta kunci gantian dalam konsol pada bila-bila masa. Kunci lama terus berfungsi selama 24 jam selepas itu, supaya anda boleh beralih tanpa gangguan perkhidmatan.
Status kunci
- Aktif: kunci berfungsi.
- Dijeda: kunci ditolak dengan
key_paused. Ia disambung semula dengan sendirinya apabila puncanya diselesaikan. - Dibatalkan: kunci ditolak secara kekal dengan
unauthenticated.
Jika pembayaran pembaharuan gagal, kunci anda terus berfungsi dalam tempoh tangguh selama 5 hari sementara kami menghantar e-mel kepada anda pada setiap peringkat, dan kemudian ia dijeda. Kunci yang dijeda disambung semula secara automatik sebaik sahaja pembayaran dijelaskan. Pertikaian pembayaran menjeda kunci serta-merta sehingga pertikaian itu disemak.
Penambahan negara atau naik taraf dicaj secara prorata serta-merta, dan digunakan pada kunci yang sama sejurus selepas pembayaran disahkan. Pembuangan negara atau turun taraf berkuat kuasa pada pembaharuan seterusnya.