Yazılımcılar için

Genel REST API

Erişim ve kimlik doğrulama

Temel adres: https://api.blinkerbot.com/v1. Genel özellik bayrağı ve çalışma alanının PUBLIC_API yetkisi açık olmalıdır; özellik varsayılan olarak kapalıdır. Hesap sahibi veya yönetici Ayarlar → Geliştirici bölümünde yeni 2FA koduyla kapsamlı anahtar oluşturur. Güvenlik değişikliklerinden sonra 24 saat beklenir. Anahtarı hemen kopyalayın; yalnızca bir kez gösterilir. Otomatik süresi dolmaz; kullanılmadığında iptal edin.

Her istekte Authorization: Bearer bb_live_… gönderin. HTTPS ve güvenli kimlik bilgisi deposu kullanın. Anahtarı URL, tarayıcı paketi, tablo hücresi veya günlüğe koymayın. Yalnızca SHA-256 özeti ve son dört karakter saklanır. Listeleme özgün anahtarı göstermez. Anahtar yalnızca kendi çalışma alanına erişir; başka alanın kimliği 404 döndürür.

curl 'https://api.blinkerbot.com/v1/me' \
  -H 'Authorization: Bearer bb_live_REPLACE_WITH_YOUR_KEY'

İzinler ve yollar

  • Etkin herhangi bir anahtar: GET /v1/me; çalışma alanı kimliği, adı, slug, izinler ve API sürümü.
  • contacts:read: GET /v1/contacts ve GET /v1/contacts/{id}.
  • contacts:write: PATCH /v1/contacts/{id}.
  • conversations:read: GET /v1/conversations ve GET /v1/conversations/{id}/messages.
  • bookings:read: GET /v1/bookings.
  • webhooks:manage: GET /v1/webhooks, POST /v1/webhooks, DELETE /v1/webhooks/{id}.

Otomasyonunuz için gerekli en dar izinleri seçin. Yazma işlemleri etkinlik günlüğüne kaydedilir. Yapay zekâ belleği, ham sağlayıcı verileri, kayıt adresleri ve kimlik bilgileri yanıtlara eklenmez.

Kişiler

curl 'https://api.blinkerbot.com/v1/contacts?limit=50&updated_since=2026-11-12T00%3A00%3A00Z' \
  -H 'Authorization: Bearer bb_live_REPLACE_WITH_YOUR_KEY'

phone, email ve search parametreleri alt metin arar. E-posta araması büyük/küçük harfe duyarsızdır. search telefon veya e-postada arar. updated_since, saat dilimi içeren RFC3339 zaman damgasından sonraki değişiklikleri getirir. Kişi etiketi değişiklikleri updatedAt değerini ilerletir. Yanıt alanları: id, name, phone, email, notes, createdAt, updatedAt, tags: [{"name":"Nitelikli"}].

curl -X PATCH 'https://api.blinkerbot.com/v1/contacts/contact_example' \
  -H 'Authorization: Bearer bb_live_REPLACE_WITH_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  --data '{"name":"Ada","email":"ada@example.com","phone":"+905550000000","notes":"Call tomorrow","tags":{"add":["Qualified"],"remove":["New"]}}'

Alanlar isteğe bağlıdır. null bir metin alanını temizler. Üst sınırlar: ad 200, e-posta 320, telefon 64, not 2000, etiket adı 48 karakter. En az bir alan gönderin. Etiketler kişi etiketleridir; sohbet konularından ayrıdır. Toplam en fazla 50 etiket ekleme/çıkarma girdisi kabul edilir. Var olanı eklemek veya olmayanı çıkarmak güvenlidir. Panelle aynı normalleştirme, etiket sahipliği ve işlem mantığı kullanılır; webhook olayı aynı veritabanı işleminde oluşur.

Sayfalama ve filtreler

{"data":[{"id":"contact_example","name":"Ada","phone":"+905550000000","email":"ada@example.com","notes":null,"createdAt":"2026-11-12T12:00:00Z","updatedAt":"2026-11-12T12:00:00Z","tags":[]}],"next_cursor":"opaque_cursor"}

limit varsayılan 50, en fazla 100'dür. next_cursor değerini değiştirmeden sonraki istekte cursor olarak ve aynı filtrelerle gönderin. Null listenin sonudur. Kişiler, sohbetler ve randevular updatedAt sonra kimliğe göre artan sıradadır. Mesajlar oluşturma zamanı ve kimliğe göre sıralanır. İmleçler kaynağa özeldir; kendiniz üretmeyin. Listeler canlı veriyi gösterir: düzenlenen kayıt tekrar görülebilir. Kimliğe göre tekrarları önleyip sonraki eşitlemede örtüşen bir zaman aralığı kullanın.

Sohbetler updated_since kabul eder. Mesajlar için size ait sohbet kimliği gerekir. Randevularda start_from dahil ve start_to hariç olacak şekilde başlangıç zamanı filtrelenir; ikisi de RFC3339 olmalıdır. Örnek: /v1/bookings?start_from=2026-11-12T00%3A00%3A00Z&start_to=2026-11-13T00%3A00%3A00Z.

REST hooks: abone olma ve silme

curl -X POST 'https://api.blinkerbot.com/v1/webhooks' \
  -H 'Authorization: Bearer bb_live_REPLACE_WITH_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  --data '{"url":"https://receiver.example/hooks/leads","description":"CRM leads","eventTypes":["lead.captured","contact.updated"]}'

201 yanıtı { "data": { "id": "endpoint_example", "url": "…", "eventTypes": ["lead.captured","contact.updated"], "enabled": true, "secret": "whsec_…" } } ve ek alıcı bilgilerini içerir. secret ve id değerlerini saklayın; GET imza anahtarını göstermez. Kapalı olanlar dahil en fazla 10 alıcı bulunabilir. Herkese açık HTTPS zorunludur. Özel ağ adresleri, yerel adlar, URL içinde kimlik bilgileri, parça ve güvensiz portlar reddedilir. Bağlantı anında DNS tekrar denetlenir; yönlendirmeler izlenmez.

DELETE /v1/webhooks/endpoint_example 204 döndürür ve bu alıcının bekleyen gönderimlerini kaldırır. Sonraki silme 404'tür. GET anahtarları göstermeden abonelikleri listeler. İmza yenileme ve döküm ekleme panelde hesap sahibinin kontrolündedir. REST aboneliklerinde döküm varsayılan kapalıdır. Mesaj olayları yalnızca ayrıca seçilirse gönderilir. Olay kataloğu, imza ve kurulum tarifleri.

Hız sınırı ve hatalar

Her anahtar tüm API kopyalarında ortak 60 istek/dakika sınırına tabidir. RateLimit-Limit ve RateLimit-Remaining kalan kotayı bildirir. 429 yanıtındaki Retry-After saniye cinsindendir; tekrar denemeden önce en az bu süreyi bekleyin. Hız sınırlayıcı veya depolama kesintisinde erişim 503 ile durur.

{"error":{"code":"insufficient_scope","message":"insufficient scope"}}
  • 400: invalid_request, invalid_cursor, invalid_range, invalid_url, endpoint_limit.
  • 401: unauthorized; eksik, geçersiz veya iptal edilmiş anahtar.
  • 403: insufficient_scope, entitlement_required.
  • 404: not_found; başka çalışma alanının kaydı dahil.
  • 429: rate_limited.
  • 503: service_unavailable, rate_limit_unavailable.

Özellik açıkken openapi.json adresinde OpenAPI 3.1 sözleşmesi bulunur. İstek/yanıt şemaları, filtreler, kimlik doğrulama ve izinler açıklanır. Resmi Zapier/Make uygulama listelemeleri ve yerel CRM bağlantıları sonraki adımlardır; genel Webhook/HTTP modülleri bu sözleşmeyle kullanılabilir.