Rocketly API

Web formlarından gelen lead'leri Rocketly'ye güvenli biçimde aktarmak için webhook ve kaynak yönetimi uçlarını kullanın.

Ücretsiz Başla Endpoint'leri İncele

Öne Çıkan Özellikler

Güvenli Kimlik Doğrulama

Yönetim uçları JWT ile korunur; gelen webhook ucu kaynak anahtarıyla doğrulanır. Yönetim tokenını tarayıcıya koymayın; anahtar açığa çıkarsa kaynak ayarlarından yenileyin.

Gelen Lead Yakalama

Form veya sunucu tarafı entegrasyonunuzdan gelen veriyi doğrulanmış webhook kaynağına iletin.

Kaynak Yönetimi

Yetkili kullanıcılar kaynak oluşturabilir, listeleyebilir ve gerekli alan eşlemelerini yönetebilir.

Kaynak Sağlığı

Her kaynak için son 24 saatlik sağlık bilgisini ve sorunlu teslimatları inceleyin.

Webhook Entegrasyonu

Kaynak başına oluşturulan webhook URL'si ve takip betiğiyle web sitenizden lead yakalayın.

Teslimat Kayıtları

Kaynak bazlı kayıtlarla gelen istekleri gözden geçirin ve başarısız teslimatları teşhis edin.

API Endpoint'leri

Webhook & Form Entegrasyonu

POST/api/webhook/lead/{api_key}Web formundan lead al

GET/api/webhook/sourcesWebhook kaynaklarını listele

POST/api/webhook/sourcesWebhook kaynağı oluştur

GET/api/webhook/sources/{source_id}/healthSon 24 saatin kaynak sağlığını görüntüle

GET/api/webhook/sources/{source_id}/logsKaynağın teslimat kayıtlarını incele

GET/api/webhook/tracker.jsWebsite tracking script

Güvenli kurulum akışı

Bu sayfa Rocketly'nin gelen lead yakalama entegrasyonunu açıklar. Yönetim uçları oturum, uygun plan özelliği ve settings.integrations izni gerektirir.

Kaynak oluşturun. Ayarlar > Entegrasyonlar'da bir webhook kaynağı açın; oluşturulan URL yalnız gelen lead kabul eder.
Gönderimi test edin. Sunucunuzdan veya form altyapınızdan POST /api/webhook/lead/{api_key} ile bir test verisi gönderin.
Sağlığı ve kayıtları inceleyin. Kaynak ayrıntısından teslimat kayıtlarını ve son 24 saatlik sağlık görünümünü kontrol edin; erişim anahtarı açığa çıkarsa yenileyin.

Örnek Kullanım

cURL - Lead Oluşturma

curl -X POST https://api.gorocketly.com/api/webhook/lead/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Ahmet",
    "last_name": "Yılmaz",
    "phone_raw": "05321234567",
    "email": "[email protected]",
    "status": "Açık"
  }'

Kimlik doğrulama

İki ayrı kimlik doğrulama yolu vardır: yönetim uçları için oturum tokenı ya da kişisel erişim tokenı (PAT), gelen webhook ucu için ise kaynağa özel anahtar.

Kişisel erişim tokenı. Token fl_pat_ önekiyle üretilir ve yalnızca oluşturulduğu anda bir kez gösterilir; sunucuda düz metin değil, özeti saklanır. İsteğe iki başlıktan biriyle eklenir: Authorization: Bearer fl_pat_… veya X-API-Key: fl_pat_….
Kapsamlar (scope). Kapsam listesi boş bırakılırsa token, kullanıcının kendi izinleri kadar erişir. Kapsam verildiğinde etkin izin, kullanıcının izinleriyle KESİŞİM alınarak hesaplanır — bir kapsam, sahip olunmayan bir izni veremez. leads.* ve * gibi joker değerler desteklenir; tanınmayan bir kapsam 422 ile reddedilir.
Yaşam süresi ve iptal. expires_in_days 1–365 gün arasında verilebilir; boş bırakılırsa token süresizdir. Token DELETE /api/pat/{token_id} ile anında iptal edilir. Geçersiz veya iptal edilmiş kimlik bilgisi 401 ve WWW-Authenticate: Bearer başlığı döndürür.
Gelen webhook ucu. Bu uç, isteği bir gövde imzasıyla değil, URL'deki kaynak anahtarıyla doğrular. Anahtar flwh_ önekiyle üretilir, sunucuda SHA-256 özeti saklanır ve karşılaştırma sabit zamanlı (timing-safe) yapılır. Ayrı bir imza başlığı yoktur; bu yüzden webhook URL'si bir sır gibi saklanmalı ve sızdığından şüphelenildiğinde kaynak ayarlarından yenilenmelidir.
Ek kısıtlar. Her kaynak için IP ve alan adı izin listesi tanımlanabilir; listelerin dışından gelen istek 403 alır.

Kişisel Erişim Tokenları

POST/api/patToken oluştur (düz metin bir kez döner)

GET/api/patTokenları maskeli olarak listele

DELETE/api/pat/{token_id}Tokenı iptal et

Hız limitleri

Hız limiti hem uç bazında hem de platform genelinde uygulanır. Limit durumunu tahmin etmeye çalışmayın; her yanıtın başlıklarından okuyun.

Gelen lead ucu. Kaynak anahtarı başına dakikada 60 istek. Aşıldığında 429 ve Retry-After: 60 döner.
Genel kota. Diğer uçlar için varsayılan dakikada 100 istektir; bazı uçlarda daha dardır.
Başlıklar. Her yanıt X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset taşır; 429 yanıtı ayrıca Retry-After içerir.
429 gövdesi. error, limit, remaining ve retry_after alanlarını içerir. Yeniden denemede Retry-After değerini bekleyin.
Gövde boyutu. Gelen lead isteği en fazla 100 KB olabilir; aşan istek 413 ile reddedilir.

Yanıtlar ve hata kodları

Gelen lead ucu, iş sonucunu HTTP durum koduna değil gövdedeki status alanına yazar; başarılı bir istek her zaman 200 döner.

created. Yeni lead oluşturuldu; gövdede lead_id döner.
updated. Kayıt mükerrer bulundu; yeni kayıt açılmaz, mevcut lead güncellenir ve onun lead_id değeri döner.
spam. İstek spam olarak işaretlendi; lead oluşturulmaz.
error. Telefon veya e-posta alanlarından en az biri gereklidir; ikisi de yoksa success: false döner.
Hata kodları. 400 okunamayan veya geçersiz gövde · 403 IP/alan adı izin listesi dışı · 404 geçersiz ya da devre dışı webhook anahtarı · 413 gövde 100 KB'ı aşıyor · 429 hız limiti.
Tarayıcıdan açılırsa. Aynı URL'e GET ile gidildiğinde lead oluşmaz; uç, beklenen gövdeyi anlatan bilgilendirici bir JSON döndürür.

Sürümleme

Tüm uçlar /api tabanı altında yayınlanır. Yeni yüzeyler, yayındaki yolları kırmadan açık bir /api/v2 öneki altına eklenir; /api/webhook/… gibi mevcut yollar yerinde kalır. Entegrasyonunuzda taban adresi tek bir yapılandırma değeri olarak tutun ve yol öneklerini koda gömmeyin.

Hemen Başlayın

Hesap açın, uygun çalışma alanı planı ve izinleriyle webhook kaynağı oluşturun; ardından URL'nizi güvenli entegrasyon katmanınıza ekleyin.

Ücretsiz Kayıt Ol