Kurumsal Plan

Rodosto Terrain üzerinde
API ve Webhook ile geliştirin

Kapsamlı API anahtarları oluşturun, gerçek zamanlı webhook olaylarına abone olun ve mülk verilerini herhangi bir harici sisteme entegre edin. Emlak platformuna programatik erişim gerektiren geliştiriciler için tasarlandı.

Ayrıntılı kapsamlara sahip API anahtarları

Belirli izin kapsamlarına sahip isimlendirilmiş API anahtarları oluşturun. Her anahtar, günlüklerinizde kolay tanımlama için benzersiz bir önek alır. Tam anahtar yalnızca oluşturma sırasında bir kez gösterilir -- güvenli bir şekilde saklayın.

// Örnek API isteği
GET /api/v1/listings
Authorization: Bearer rt_k7x2...
X-RateLimit-Remaining: 498

Webhook olay abonelikleri

Belirli olaylara abone olun ve uç noktanıza gerçek zamanlı HTTP POST bildirimleri alın. Bireysel olaylar seçin veya her şeyi yakalamak için joker karakter kullanın.

inquiry.created

Portföyünüz veya ilan sayfanız üzerinden yeni bir müşteri talebi gönderildiğinde tetiklenir.

listing.created

Platformda yeni bir mülk ilanı yayınlandığında tetiklenir.

listing.updated

Herhangi bir ilan detayı değiştirildiğinde tetiklenir -- fiyat, durum, açıklama veya medya.

listing.sold

Bir ilan satıldı olarak işaretlendiğinde tetiklenir, sonraki CRM güncellemelerini mümkün kılar.

portfolio.viewed

Bir ziyaretçi portföy sayfanızı görüntülediğinde, yönlendiren verilerle birlikte tetiklenir.

* (tüm olaylar)

Joker karakter aboneliği, tek bir uç noktada tüm olay türlerini yakalar.

HMAC-SHA256 imza doğrulama

Her webhook teslimatı, webhook sırrınızla hesaplanan bir HMAC-SHA256 imzasını başlıkta içerir. Yükün özgün ve değiştirilmemiş olduğundan emin olmak için imzayı sunucu tarafında doğrulayın.

// Webhook imzasını doğrula (Node.js)
const crypto = require('crypto');
const signature = req.headers['x-rt-signature'];
const expected = crypto
  .createHmac('sha256', webhookSecret)
  .update(req.body)
  .digest('hex');
const valid = crypto.timingSafeEqual(
  Buffer.from(signature),
  Buffer.from(expected)
);

Otomatik yeniden deneme ve test

Başarısız webhook teslimatları üstel geri çekilme ile otomatik olarak yeniden denenir. Panodan teslimat durumunu ve başarısızlık sayılarını takip edin. Canlıya geçmeden önce uç noktanızı doğrulamak için yerleşik test tetikleyicisini kullanın.

Sıkça Sorulan Sorular

Hangi planlar API erişimi içerir?

API anahtarları ve webhook abonelikleri Kurumsal plana özeldir. Bu, entegrasyon iş akışları için kurumsal düzeyde hız limitleri ve özel destek sağlar.

Kaç API anahtarı oluşturabilirim?

API anahtarı sayısında kesin bir sınır yoktur. Farklı kapsamlar ve hız limitleriyle her entegrasyon veya ortam (staging, production) için ayrı anahtarlar oluşturun.

Webhook uç noktam çökerse ne olur?

Başarısız teslimatlar üstel geri çekilme ile otomatik olarak yeniden denenir. Birden fazla ardışık başarısızlıktan sonra abonelik başarısız olarak işaretlenir ve bir e-posta bildirimi alırsınız. Uç noktanız tekrar çevrimiçi olduğunda yeniden etkinleştirebilirsiniz.

Webhook yüklerinde hangi veri alanlarının dahil edileceğini filtreleyebilir miyim?

Webhook yükleri varsayılan olarak tam olay verilerini içerir. Verileri alıcı sunucunuzda filtreleyebilir ve dönüştürebilirsiniz. Yük yapısı API referansında belgelenmiştir.

Emlak iş akışınızı
entegre etmeye hazır mısınız?

Ücretsiz başlayın, API erişimi için Kurumsal plana geçin. Dakikalar içinde özel entegrasyonlar oluşturun.

Ücretsiz Başlayın