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.

Anahtar edinme

Anahtarı konsolda abone olarak edinirsiniz. Onay sırası yoktur ve e-posta göndermeniz gerekmez.

  1. Konsolda oturum açın veya bir hesap oluşturun. Bu, diğer Housing Market ürünleri için kullandığınız hesabın aynısıdır.
  2. Ülkeleri, bir bölgeyi veya dünya genelini, planı ve aylık ya da yıllık faturalandırmayı seçin.
  3. Sunucularınızın API'yi çağıracağı IP adresini girin.
  4. API kullanım koşullarını kabul edin. Neyi ve ne zaman kabul ettiğinizin kaydını tutarız.
  5. Ödemeyi yapın. Anahtarınız yalnızca ödeme başarılı olduktan sonra görünür ve yalnızca bir kez gösterilir.

Anahtarı doğrudan gizli bilgi deponuza kopyalayın. Anahtarın yalnızca tek yönlü bir özetini (hash) saklarız; bu nedenle onu size tekrar gösteremeyiz. Bir anahtar hma_<prefix>_<secret> biçimindedir.

Konsolda istediğiniz zaman yedek bir anahtar oluşturabilirsiniz. Bunu yaptıktan sonra eski anahtar 24 saat boyunca çalışmaya devam eder; böylece kesinti yaşamadan geçiş yapabilirsiniz.

Anahtar durumları

  • Etkin: anahtar çalışır.
  • Duraklatıldı: anahtar key_paused ile reddedilir. Neden ortadan kalktığında kendiliğinden yeniden çalışır.
  • İptal edildi: anahtar kalıcı olarak unauthenticated ile reddedilir.

Bir yenileme ödemesi başarısız olursa anahtarınız 5 günlük bir ek süre boyunca çalışmaya devam eder; bu süre içinde her adımda size e-posta göndeririz, ardından anahtar duraklatılır. Duraklatılmış bir anahtar, ödeme tamamlanır tamamlanmaz otomatik olarak yeniden çalışır. Bir ödeme itirazı, anahtarı inceleme tamamlanana kadar hemen duraklatır.

Ülke eklemek veya planı yükseltmek hemen kıst esasına göre ücretlendirilir ve ödeme onaylandıktan kısa süre sonra aynı anahtara uygulanır. Ülke çıkarmak veya planı düşürmek bir sonraki yenilemede geçerli olur.