Hata Kodları
Hata Kodları
GoVista API tarafından döndürülen API hata kodları referansı.
HTTP Durum Kodları
| Kod | Anlam | Açıklama | |-----|-------|----------| | 200 | Başarılı | İstek başarılı oldu | | 201 | Oluşturuldu | Kaynak başarıyla oluşturuldu | | 204 | İçerik Yok | İstek başarılı, yanıt gövdesi yok | | 400 | Hatalı İstek | Geçersiz istek parametreleri | | 401 | Yetkisiz | Eksik veya geçersiz API anahtarı | | 403 | Yasak | Geçerli anahtar ama yetersiz izinler | | 404 | Bulunamadı | Kaynak mevcut değil | | 409 | Çakışma | Kaynak zaten var veya durum çakışması | | 422 | İşlenemez | Geçerli istek ama semantik hatalar | | 429 | Çok Fazla İstek | Hız limiti aşıldı | | 500 | Sunucu Hatası | İç sunucu hatası |
Uygulama Hata Kodları
Kimlik Doğrulama Hataları:
AUTH_INVALID_KEY— API anahtarı geçersiz veya süresi dolmuşAUTH_INSUFFICIENT_SCOPE— Anahtar gerekli kapsama sahip değilAUTH_EXPIRED_SESSION— Oturum süresi doldu, yeniden kimlik doğrulayın
Cihaz Hataları:
DEVICE_NOT_FOUND— Cihaz kimliği mevcut değilDEVICE_OFFLINE— Çevrimdışı cihaza komut gönderilemiyorDEVICE_ALREADY_PAIRED— Cihaz zaten bir organizasyona eşleştirilmişPAIRING_CODE_EXPIRED— eşleştirme kodunun süresi dolmuşPAIRING_CODE_INVALID— Eşleştirme kodu yanlış
İçerik Hataları:
CONTENT_NOT_FOUND— İçerik varlığı mevcut değilCONTENT_TOO_LARGE— Dosya maksimum yükleme boyutunu aşıyorCONTENT_INVALID_FORMAT— Desteklenmeyen dosya formatıCONTENT_PROCESSING_FAILED— Sunucu yüklenen dosyayı işleyemedi
Playlist Hataları:
PLAYLIST_NOT_FOUND— Playlist mevcut değilPLAYLIST_EMPTY— Boş playlist dağıtılamazPLAYLIST_ITEM_NOT_FOUND— Playlistteki içerik öğesi silinmiş
Programatik hata yönetimi için her zaman hata yanıtlarındaki error.code alanını kontrol edin. error.message alanı hata ayıklama için faydalı, okunabilir detaylar sağlar.
Zamanlama Hataları:
SCHEDULE_NOT_FOUND— Zamanlama mevcut değilSCHEDULE_CONFLICT— Zaman kuralı mevcut kurallarla çakışıyorSCHEDULE_INVALID_RULE— Kural yapılandırması geçersiz
Hız Limiti Hataları:
RATE_LIMIT_EXCEEDED— Çok fazla istek, Retry-After başlığını kontrol edin
Hata Yönetimi
En iyi uygulamalar:
1. Her zaman önce HTTP durum kodunu kontrol edin 2. Programatik yönetim için hata kodunu ayrıştırın 3. Hata ayıklama için tam hata yanıtını kaydedin 4. 429 hataları için üstel geri çekilme uygulayın 5. Kalıcı 500 hataları için desteğe başvurun
400, 401, 403 veya 404 hatalarında yeniden denemeyin. Bunlar düzeltilmesi gereken bir istek sorununu gösterir, geçici sunucu sorunu değil. Yalnızca 429 ve 500 hatalarında yeniden deneyin.