OLAB Assist REST API

Ne elde edersiniz

• Hesap, siteler, site detayı, bulgular, yapay zekâ yanıtları, puan geçmişi ve değişiklikler için uç noktalar.
• Sitelere id ya da alan adıyla ulaşılır, örn. /sites/example.com.
• next_cursor ile sayfalama, anahtar başına dakikada 120 istek.
• Sürümlü sözleşme: v1 içinde alanlar yalnızca eklenir, asla kaldırılmaz veya yeniden adlandırılmaz.

Başlamadan önce

• Agency planında bir OLAB Assist hesabı ve hesap sahibi olarak giriş.
• Başlıklı 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ı: araca göre adlandırın (örn. “HubSpot senkronu”) ve Anahtar oluştur'a tıklayın. Hemen kopyalayın; yalnızca bir kez gösterilir.

2. 2

   İlk isteğinizi yapın

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

3. 3

   İhtiyacınız olan veriyi seçin

   Tam görünüm için /sites/{site}, sorunlar için /findings, yapay zekâ yanıtları için /answers, zaman içindeki puanlar için /history. Tam başvuru geliştirici dokümanında.

4. 4

   Zamanlayın

   İçe aktarmayı günlük ya da her scan.completed webhook'undan sonra çalıştırın; gereğinden fazla sorgu yapmazsınız.

curl https://api.olabassist.com/api/v1/sites \
  -H "Authorization: Bearer olab_ANAHTARINIZ"

İpuçları

• Her entegrasyon için bir anahtar: iptal ettiğinizde yalnızca o araç etkilenir.
• Bilmediğiniz alanları yok sayın. Zamanla yenileri eklenir, kodunuz çalışmaya devam eder.
• Google Sheets için UrlFetchApp kullanan bir Apps Script ve günlük tetikleyici yeterli.

Sorun giderme

Sık sorulan sorular