Skip to main content

​
Genel Bakış

Bu doküman HTTP durum kodlarını ve platformda sık görülen uyarıları, anlamlarını ve çözüm yollarını içerir.

​
HTTP Durum Kodları

​
2xx - Başarılı

​
4xx - İstemci Hataları

Anlam: İstek formatı hatalı veya eksik bilgi var.Yaygın Nedenler:
  • Zorunlu alan eksik
  • Veri format hatası
  • Geçersiz değer
Örnek Hatalar:
Çözüm:
  1. Hata mesajını okuyun
  2. Belirtilen alanı düzeltin
  3. Tekrar deneyin
Anlam: Kimlik doğrulama başarısız.Yaygın Nedenler:
  • Oturum süresi dolmuş
  • Token geçersiz
  • Giriş yapılmamış
Çözüm:
  1. Çıkış yapın
  2. Tekrar giriş yapın
  3. Tarayıcı cache temizleyin
Anlam: İşlem için yetkiniz yok.Yaygın Nedenler:
  • Kullanıcı rolünüz bu işlem için yeterli değil
  • Organizasyona ait olmayan kaynaklara erişim
  • Devre dışı bırakılmış özellik
Çözüm:
  1. Rolünüzü ve yetkilerinizi kontrol edin (Organizasyon Ayarları → Kullanıcılar). Bkz. Kullanıcı Yetkileri
  2. Organizasyonunuzun Sahip ya da Yönetici rolündeki üyesinden yetki isteyin
  3. Doğru organizasyonda olduğunuzdan emin olun
Anlam: İstenen kaynak bulunamadı.Yaygın Nedenler:
  • Kayıt silinmiş
  • Yanlış ID kullanılmış
  • URL hatalı
Çözüm:
  1. ID’yi kontrol edin
  2. Kaydın var olduğundan emin olun
  3. Sayfayı yenileyin
Anlam: İşlem bir çakışmaya neden oluyor.Yaygın Nedenler:
  • Aynı isimde kayıt zaten var
  • Duplicate entry
  • Conflicting state
Örnek:
Çözüm:
  1. Benzersiz bir isim kullanın
  2. Mevcut kaydı güncelleyin
  3. Çakışan kaydı silin
Anlam: İstek anlaşıldı ama işlenemedi.Yaygın Nedenler:
  • Validasyon hatası
  • İş kuralı ihlali
  • Bağımlılık sorunu
Örnek:
Çözüm:
  1. Hata mesajını dikkatlice okuyun
  2. Bağımlılıkları çözün
  3. Validasyon kurallarına uyun
Anlam: Çok fazla istek gönderildi (rate limiting).Yaygın Nedenler:
  • Kısa sürede çok fazla istek
  • Spam koruması
Çözüm:
  1. 1 dakika bekleyin
  2. Tekrar deneyin; sorun sürerse destek ekibine bildirin

​
5xx - Sunucu Hataları

Anlam: Sunucu tarafında beklenmeyen hata oluştu.Ne Yapmalı:
  1. Sayfayı yenileyin
  2. 5 dakika bekleyip tekrar deneyin
  3. Problem devam ediyorsa destek ekibine bildirin
Anlam: Gateway hatası, upstream servis cevap vermiyor.Yaygın Nedenler:
  • AI servisi down
  • Platform servisleri yeniden başlatılıyor
  • Network sorunu
Çözüm:
  1. 2-3 dakika bekleyin
  2. Servis status sayfalarını kontrol edin
  3. Tekrar deneyin
Anlam: Servis geçici olarak kullanılamıyor.Yaygın Nedenler:
  • Maintenance mode
  • Overload
  • Deployment
Çözüm:
  1. Status sayfasını kontrol edin
  2. 10-15 dakika bekleyin
  3. Alternatif zaman diliminde deneyin
Anlam: İstek zaman aşımına uğradı.Yaygın Nedenler:
  • Sunucu tarafında yavaş işlem
  • Database query timeout
  • External API timeout
Çözüm:
  1. İşlemi küçük parçalara bölün
  2. Daha az veri ile deneyin
  3. İşlemi tekrarlayın

​
Ekranda Görülen Yaygın Uyarılar

Platform hataları ekranda Türkçe uyarı olarak gösterir; ayrı bir hata kodu listesi yoktur. Sık görülenler:

​
Hata Çözüm Akış Şeması

​
Hata Loglarını Okuma

​
Tarayıcı Console

Nasıl Açılır:
  • Chrome/Edge: F12 veya Ctrl+Shift+I
  • Firefox: F12
  • Safari: Cmd+Option+I
Ne Aranır:
  • Kırmızı hatalar (errors)
  • Network tab > Failed requests
  • Status code ve response

​
Destek Ekibine Bildirim

Hata devam ediyorsa, hata mesajını destek ekibine bildirin. Teknik ekibimiz arka plan loglarını inceleyerek sorununuzu çözecektir.

​
İpuçları

​
Hata Aldığınızda

1

Hata Mesajını Kaydedin

Ekran görüntüsü alın
2

Hata Mesajını Okuyun

Ne diyor?
3

Bu Dokümana Bakın

Uyarının anlamı nedir?
4

Çözümü Uygulayın

Adım adım ilerleyin
5

Çözülmezse Destek

Detaylı bilgi verin

​
Destek Bildirimi

Hata raporu oluştururken: Gerekli Bilgiler:
  • Tam hata mesajı
  • Ne yapmaya çalışıyordunuz?
  • Tekrar edebilir misiniz?
  • Screenshot
  • Tarayıcı console çıktısı
Tarayıcı console hatası örneği

​
Sık Sorulan Sorular

Sunucu tarafında bir sorun var. 10-15 dakika bekleyip tekrar deneyin. Problem devam ediyorsa destek ekibine bildirin.
Oturumunuz güncel olmayabilir. Çıkış yapıp tekrar giriş yapın.
E.164 formatında olmalı: +[ülke kodu][numara]. Örnek: +905551234567
Uyarının ekran görüntüsünü alıp destek ekibine bildirin: info@aiagenttr.com

​
İlgili Makaleler

Genel Sorunlar

Yaygın platform kullanım sorunları

API Bağlantı Sorunları

API ve servis bağlantı problemleri

Çağrı Hataları

Çağrı başlatma ve yönetim hataları

Platform API Anahtarı

Platform API anahtarı yapılandırması