API Key Yönetimi
Fonify API anahtarı oluşturma, kapsam yönetimi, iptal etme ve güvenli kullanım pratiklerini öğrenin.
API Key Yönetimi
API anahtarları, dış sistemlerin Fonify'a programatik olarak bağlanmasını sağlar. Kişi ekleme, kampanya başlatma veya dış otomasyon kurma gibi işlemler bu anahtarlarla yapılır.
API Anahtarı Oluşturma
Ekip > Entegrasyonlar > API Anahtarları ekranına gidin ve yeni anahtar oluşturun.
Anahtara açıklayıcı bir ad verin. Gerekirse tam erişim yerine yalnız gerekli kapsamları açarak kısıtlı erişim kullanın.
Oluşturulan tam anahtar yalnızca bir kez gösterilir. Güvenli yere kaydedin; sonradan tekrar görüntülenmez.
API anahtarlarını istemci tarafına koymayın. Anahtarlar yalnızca sunucu tarafında, ortam değişkeni veya secret manager içinde saklanmalıdır.
Anahtar Kullanımı
API isteklerinde anahtarınızı Authorization başlığında gönderin:
curl -X GET https://app.fonify.co/api/v1/contacts \
-H "Authorization: Bearer fonify_abc123xyz789" \
-H "Content-Type: application/json"Örnek: Kişi Ekleme
curl -X POST https://app.fonify.co/api/v1/contacts \
-H "Authorization: Bearer fonify_abc123xyz789" \
-H "Content-Type: application/json" \
-d '{
"name": "Ahmet Yılmaz",
"phone": "+905321234567",
"email": "[email protected]",
"company": "ABC Ltd"
}'Uç noktaların tam listesi, kimlik doğrulama biçimi, örnek istekler ve hata kodları API referansında yer alır.
Yönetim ve Güvenlik
- Her entegrasyon için ayrı anahtar oluşturun
- Yalnız gerekli kapsamları açın
- Kullanılmayan anahtarları devre dışı bırakın veya iptal edin
- Son kullanım ve istek sayısı gibi metrikleri anahtar listesinde takip edin
Anahtar İptal Etme
Bir anahtarı iptal ettiğiniz anda o anahtar geçersiz olur. Anahtarı kullanan entegrasyonlar hemen 401 Unauthorized hatası almaya başlar.
İptal edilen anahtarlar geri alınamaz. Aynı izinlerle yeni bir anahtar oluşturmanız gerekir.
Hız Limitleri
API istekleri anahtar başına sınırlanır. Güncel sınırlar ve Retry-After davranışı API referansında yayınlanır.
İpucu
Her yeni entegrasyon için önce ayrı anahtar açın, küçük bir test isteğiyle doğrulayın, ardından üretime alın.