Genel Bakış
API anahtarları, platform ile AI servislerinin bağlantısını sağlar. Bu makale, API anahtarlarını ekleme, yönetme ve güvenli kullanma yöntemlerini açıklar.API Anahtarı Nedir?
Platform API Anahtarı: Platform’un AI servisleri ile iletişim kurması için gerekli kimlik bilgisidir. Kullanım Alanları:- AI Agent oluşturma
- Çağrı başlatma
- Webhook alma
- Ses ve transkript işleme
Platform otomatik olarak API bağlantılarını yönetir. Genellikle manuel işlem gerektirmez.
İlk API Anahtarı Kurulumu
Otomatik Yapılandırma
Platform kurulumu sırasında API bağlantısı otomatik olarak yapılandırılır:
API Anahtarı Listesi
Görüntüleme
Ayarlar > API Keys sayfasında: Bilgiler:- Servis Sağlayıcısı
- Environment (Production/Test)
- Son 4 karakter
- Ekleme tarihi
- Son kullanım
- Durum (Aktif/Pasif)
API Anahtarı Güncelleme
Anahtar Değiştirme
Ne zaman:- Anahtar expired oldu
- Güvenlik nedeniyle rotation
- Test’ten production’a geçiş
Test Bağlantısı
Anahtar Doğrulama
Test Et butonuna tıklayın:- Başarılı
- Başarısız
- ✅ “API key is valid”
- Yeşil onay işareti
- API bağlantısı OK
Çoklu Anahtar Yönetimi
Production vs Test
- Test Environment
- Production Environment
- Development ve test için
- Gerçek çağrı yapmaz
- Test modu
Güvenlik
API Anahtarı Koruması
Anahtar Rotation
Önerilen Sıklık: 3-6 ayda bir Prosedür:Güvenlik İhlali
Anahtar açığa çıktıysa:Sorun Giderme
”Invalid API Key” Hatası
Olası Nedenler
Olası Nedenler
- Anahtar yanlış kopyalanmış
- Anahtar revoke edilmiş
- Servis sağlayıcı hesabı askıda
Çözüm Adımları
Çözüm Adımları
- Anahtarı tekrar kopyalayın (boşluk vs yok)
- Servis sağlayıcı panelinde durumu kontrol edin
- Yeni anahtar oluşturun
”Connection Failed” Hatası
Olası Nedenler
Olası Nedenler
- İnternet bağlantısı yok
- AI servisleri down
- Firewall/proxy engeli
Çözüm Adımları
Çözüm Adımları
- İnternet bağlantınızı kontrol edin
- Servis sağlayıcı durum sayfasını kontrol edin
- VPN/proxy kapatıp deneyin
Agent Oluşturulamıyor
Sebep
Sebep
API key ekli değil veya geçersiz
Çözüm
Çözüm
- API Keys sayfasına gidin
- API anahtarı var mı kontrol edin
- Test Bağlantısı başarılı mı?
- Yoksa yeni anahtar ekleyin veya destek ekibi ile iletişime geçin
API Kullanım İstatistikleri
Servis Sağlayıcı Dashboard
Görüntüleme: Servis sağlayıcı panelinde Usage bölümü Bilgiler:- API call sayısı
- Başarılı/başarısız ratio
- Kullanım trendi
- Quota bilgisi
Platform İstatistikleri (Gelecekte)
Gösterilecek:- API call geçmişi
- Hata logları
- Rate limit uyarıları
Sık Sorulan Sorular
API anahtarı nereden alınır?
API anahtarı nereden alınır?
API anahtarı genellikle otomatik olarak yapılandırılır. Manuel kurulum için AI servis sağlayıcısı panelinden API Keys bölümünden oluşturabilirsiniz.
Birden fazla anahtar ekleyebilir miyim?
Birden fazla anahtar ekleyebilir miyim?
Evet, test ve production için ayrı anahtarlar ekleyebilirsiniz.
Anahtar süresi doluyor mu?
Anahtar süresi doluyor mu?
API anahtarları genellikle expire olmaz, ancak güvenlik için düzenli rotation önerilir.
Anahtar silinirse ne olur?
Anahtar silinirse ne olur?
Agent oluşturulamaz ve çağrı başlatılamaz. Yeni anahtar eklemeniz gerekir.
Test ve production anahtar farkı nedir?
Test ve production anahtar farkı nedir?
Test anahtarı test modunda çalışır, gerçek çağrı yapmaz. Production anahtarı canlı çağrılar için kullanılır.