Echovado REST API

Neler elde edersiniz?

• Hesap, siteler, site ayrıntısı, tespitler, yapay zeka yanıtları, puan geçmişi ve değişiklikler için uç noktalar.
• Sitelere id veya alan adıyla erişilebilir, ör. /sites/yourbrand.example.
• next_cursor ile sayfalama; anahtar başına dakikada 120 istek.
• Sürümlendirilmiş sözleşme: v1 içinde alanlar yalnızca eklenir, hiçbir zaman kaldırılmaz veya yeniden adlandırılmaz.

Başlamadan önce

• Agency planında, hesap sahibi olarak oturum açılmış bir Echovado hesabı.
• Başlık (header) ile HTTP isteği gönderebilen bir araç (curl, Postman, CRM'iniz, bir betik).

Adım adım kurulum

1. 1

   Anahtar oluşturun

   Entegrasyonlar → API anahtarları: anahtara aracın adını verin (ör. “HubSpot senkronizasyonu”) ve Anahtar oluştur düğmesine tıklayın. Anahtarı hemen kopyalayın; yalnızca bir kez gösterilir.

2. 2

   İlk isteğinizi gönderin

   Anahtarı Authorization başlığında gönderin. Aşağıdaki örnek, sitelerinizi son puanlarıyla listeler.

3. 3

   İhtiyacınız olan verileri seçin

   Tam tablo için /sites/{site}, sorunlar için /findings, yapay zeka yanıtları için /answers, zaman içindeki puanlar için /history kullanın. Tam referans geliştirici belgelerinde.

4. 4

   Zamanlayın

   İçe aktarmayı günde bir kez ya da her scan.completed webhook'undan sonra çalıştırın; böylece hiçbir zaman gerekenden fazla sorgu göndermezsiniz.

curl https://api.echovado.com/api/v1/sites \
  -H "Authorization: Bearer ecv_YOUR_KEY"

İpuçları

• Her entegrasyon için bir anahtar: bir anahtarı iptal etmek yalnızca o aracı etkiler.
• Tanımadığınız alanları yok sayın. Zamanla yeni alanlar eklenir ve kodunuz çalışmaya devam eder.
• Google Sheets için UrlFetchApp kullanan bir Apps Script ve günlük bir tetikleyici yeterlidir.

Sorun giderme

Sık sorulan sorular