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:1
Organizasyon Oluşturma
Organizasyon oluşturma sırasında API servisi otomatik olarak bağlanır
2
Bağlantı Testi
Sistem otomatik olarak bağlantı testini gerçekleştirir
3
Doğrulama
Bağlantı durumu gösterilir
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ş
1
Yeni Anahtar Alın
AI servis sağlayıcısından yeni anahtar oluşturun
2
Platform'da Güncelleyin
- Platform > API Keys > Düzenle
- Yeni anahtarı girin
- Test Bağlantısı
3
Kaydedin
Kaydet butonuna tıklayın
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
1
Anahtarı Kontrol Edin
Anahtarı doğru kopyaladığınızdan emin olun
2
Servis Durumunu Kontrol Edin
AI servis sağlayıcısında anahtarın aktif olduğunu kontrol edin
3
Yeni Anahtar Deneyin
Gerekirse yeni anahtar oluşturup deneyin
Ç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:1
Yeni Anahtar Oluşturun
Servis sağlayıcısından yeni anahtar oluşturun
2
Platform'da Güncelleyin
Platform’da yeni anahtarı güncelleyin
3
Test Edin
Bağlantıyı test edin
4
Eski Anahtarı Silin
Eski anahtarı servis sağlayıcısından silin
Güvenlik İhlali
Anahtar açığa çıktıysa:1
Hemen İptal Edin
Servis sağlayıcısından anahtarı hemen revoke edin
2
Yeni Anahtar Oluşturun
Yeni anahtar oluşturun
3
Platform'da Güncelleyin
Platform’da yeni anahtarı güncelleyin
4
Aktivite Kontrol Edin
Şüpheli aktivite olup olmadığını kontrol edin
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.
İlgili Makaleler
Organizasyon Oluşturma
Yeni organizasyon oluşturma
Organizasyon Ayarları
Organizasyon konfigürasyonlarını yönetin
AI Agent Oluşturma
Yapay zeka destekli sesli asistanlar oluşturun