API Dokümantasyonu

1. Anahtarınız

Her işletmenin kendi anahtarı vardır ve yalnızca o işletmenin yorumlarına erişir. Anahtarı işletme ayarlarından oluşturur, yeniler veya iptal edersiniz.

Anahtarınızı almak için Replai hesabınıza giriş yapın; işletme ayarlarından tek tıkla oluşturabilirsiniz. Giriş Ücretsiz Başla

2. İstek

Anahtarı X-Api-Key başlığında gönderin:

GET https://replai.digitalkure.com/api/public/reviews
X-Api-Key: ANAHTARINIZ

Başlık gönderemiyorsanız ?api_key=... parametresi de kabul edilir (başlık tercih edilir).

İsteğe bağlı parametreler

Parametre	Açıklama	Örnek
`limit`	Kaç yorum döneceği (1–200)	`?limit=10`
`min_rating`	En düşük yıldız (1–5)	`?min_rating=4`

3. Yanıt

{
  "business": "İşletme Adı",
  "count": 12,
  "reviews": [
    {
      "id": 8542,
      "author": "Ayşe K.",
      "rating": 5,
      "body": "Hizmetten çok memnun kaldık...",
      "date": "2026-07-30T10:47:34+00:00"
    }
  ]
}

Alan	Açıklama
`business`	İşletme adı
`count`	Dönen yorum sayısı
`reviews[].author`	Yorumu yazan kişi
`reviews[].rating`	Yıldız (1–5)
`reviews[].body`	Yorum metni
`reviews[].date`	Yorum tarihi (ISO 8601)

Yalnızca metin içeren yorumlar döner, en yeniden eskiye sıralıdır.

4. Örnekler

const res = await fetch('https://replai.digitalkure.com/api/public/reviews?limit=10&min_rating=4', {
  headers: { 'X-Api-Key': 'ANAHTARINIZ' }
});
const { reviews } = await res.json();
console.log(reviews);

$ch = curl_init('https://replai.digitalkure.com/api/public/reviews?limit=10');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['X-Api-Key: ANAHTARINIZ'],
]);
$data = json_decode(curl_exec($ch), true);
foreach ($data['reviews'] as $r) {
    echo $r['author'], ' - ', $r['rating'], '★', PHP_EOL;
}

curl -H "X-Api-Key: ANAHTARINIZ" \
  "https://replai.digitalkure.com/api/public/reviews?limit=10&min_rating=4"

<div id="yorumlar"></div>

<script>
fetch('https://replai.digitalkure.com/api/public/reviews?limit=6&min_rating=4', {
  headers: { 'X-Api-Key': 'ANAHTARINIZ' }
})
  .then(r => r.json())
  .then(({ reviews }) => {
    document.getElementById('yorumlar').innerHTML = reviews.map(r => `
      <div class="yorum">
        <strong>${r.author}</strong>
        <span>${'★'.repeat(r.rating)}</span>
        <p>${r.body}</p>
      </div>
    `).join('');
  });
</script>

5. Hatalar & limitler

Kod	Anlamı
200	Başarılı
403	Anahtar eksik, hatalı veya iptal edilmiş
429	Hız sınırı aşıldı — dakikada 60 istek

6. Güvenlik

Hedef işletme yalnızca anahtardan çözülür; istekte işletme kimliği gönderilmez. Bir anahtar başka bir müşterinin verisine asla erişemez.
Yanıtta yalnızca herkese açık alanlar bulunur. Google yorum kimlikleri, AI taslakları, gönderilen yanıtlar ve hesap bilgileri paylaşılmaz.
Anahtarı tarayıcıya giden JavaScript'e gömmek yerine, mümkünse isteği kendi sunucunuzdan yapıp sonucu birkaç dakika önbelleğe alın.
Anahtar sızdıysa işletme ayarlarından yenileyin — eski anahtar anında geçersiz olur.