Geliştiriciler
REST API ve API anahtarları
API anahtarı oluşturma, kimlik doğrulama, istek sınırı ve hata biçimi.
REST API ile web formunuzdan, reklamlarınızdan, CRM'inizden veya Zapier/Make üzerinden kişi ekleyebilir, kişileri kampanyaya koyabilir ve görüşme sonuçlarını çekebilirsiniz.
Adres: https://panel.etemsilci.com/api/v1
İstek ve cevaplar JSON'dur.
API anahtarı oluşturma
- Ayarlar → API ve Zapier sayfasını açın (yalnızca Sahip ve Yönetici).
- Yeni API anahtarı'na basın, bir ad verin (ör. "Web sitesi formu", "Zapier") ve Oluştur'a basın.
- Gösterilen anahtarı hemen kopyalayıp güvenli bir yere kaydedin. Anahtar güvenliğiniz için bir daha gösterilmez.
Her bağlantı için ayrı anahtar oluşturmanızı öneririz. Kullanılmayan anahtarı İptal et ile kapatın; o anahtarı kullanan bağlantılar hemen çalışmayı durdurur. Anahtarlar et_live_ ile başlar. Listede her anahtarın oluşturulma ve son kullanım tarihi görünür.
Kimlik doğrulama
Her isteğe şu başlığı ekleyin:
Authorization: Bearer et_live_…
curl "https://panel.etemsilci.com/api/v1/campaigns" \
-H "Authorization: Bearer et_live_…"
İstek sınırı
Anahtar başına dakikada en fazla 120 istek gönderebilirsiniz. Sınır aşılırsa 429 döner; Retry-After başlığı kaç saniye beklemeniz gerektiğini söyler.
Hatalar
Hatalar her zaman aynı biçimdedir:
{"error": {"code": "validation_failed", "message": "…", "fields": {"phone": ["Geçerli bir telefon numarası girin."]}}}
| HTTP | code |
Anlamı |
|---|---|---|
| 401 | unauthenticated |
Anahtar yok, hatalı ya da iptal edilmiş. |
| 403 | tenant_suspended |
Firmanın hesabı askıya alınmış. |
| 404 | not_found |
Kayıt bulunamadı (başka firmanın kaydı da 404 döner). |
| 422 | validation_failed |
Alan hataları; ayrıntılar fields içinde. |
| 429 | rate_limited |
Dakikada en fazla 120 istek. |
Uç noktalar için API uç noktaları makalesine bakın.