API anahtarları ve kapsamlar

Her istek bir API anahtarı ile imzalanır; anahtarın yapabildiklerini kapsamlar belirler.

Anahtar oluşturma

Anahtarı firma panelinde Ayarlar → API ve Webhook’lar ekranından oluşturursunuz (app.apsilo.com/settings/integrations ). Anahtar apsk_live_… önekiyle başlar ve yalnızca oluşturma anında bir kez gösterilir; Apsilo yalnızca SHA-256 özetini saklar.

Kaybederseniz yeni anahtar oluşturup eskisini iptal edin. Firma başına en fazla 25 anahtar tanımlanabilir.

Authorization: Bearer apsk_live_xxxxxxxxxxxxxxxxxxxx
 
# ya da
X-API-Key: apsk_live_xxxxxxxxxxxxxxxxxxxx

curl https://app.apsilo.com/api/public/v1/me \
  -H "Authorization: Bearer apsk_live_…"
 
# → { "data": { "tenant": {...}, "scopes": [...], "channels": [...] } }

Kapsamlar

Anahtar oluştururken yalnızca ihtiyacınız olan kapsamları seçin. Etkin yetki kapsam ∩ firma lisansı kesişimidir; kapsam verilmiş olsa bile lisansta kapalı özellik kullanılamaz.

Hız sınırı

Her anahtarın dakikalık istek sınırı vardır: varsayılan 600 istek/dakika, panelden 6000’e kadar yükseltilebilir. Sınır aşıldığında 429 ve RATE_LIMITED döner. Her yanıtta kalan hak başlıklarda bildirilir:

Toplu gönderimlerde 429 aldığınızda üstel bekleme (exponential backoff) ile tekrar deneyin; kampanya gibi yüksek hacimli işler için mesajları tek tek göndermek yerine /campaigns uç noktalarını kullanın.

Ek güvenlik önlemleri