Hata Kodları

Hazırlayan: Aether365 Ekibi Hedef Kitle: Geliştiriciler ve BT yöneticileri Kapsam: Aether365 API hata kodlarının tam referansı

Tüm API hataları tutarlı bir JSON yapısı döndürür:

{
  "success": false,
  "error": {
    "code": "SNAKE_CASE_ERROR_CODE",
    "message": "Human-readable description",
    "details": {}
  }
}

Kimlik Doğrulama

Kod	HTTP	Anlam	Çözüm
AUTH_MISSING_TOKEN	401	İstekte Authorization başlığı yok	Her istekte Authorization: Bearer <token> başlığını ekleyin
AUTH_INVALID_TOKEN	401	JWT doğrulanamadı	Token'ın bozuk veya kesilmiş olmadığını kontrol edin
AUTH_EXPIRED_TOKEN	401	JWT'nin süresi dolmuş	Tekrar oturum açarak veya oturumu yenileyerek yeni bir token alın
AUTH_INSUFFICIENT_SCOPE	403	Kimlik doğrulanmış hesap bu işlem için izne sahip değil	Gerekli role sahip bir hesap kullandığınızı doğrulayın

Yetkilendirme

Kod	HTTP	Anlam	Çözüm
TENANT_ACCESS_DENIED	403	İstek başka bir tenant'ın verilerine erişmeye çalıştı	Normal kullanımda asla oluşmamalıdır - görüyorsanız destek ile iletişime geçin
AUTH_INSUFFICIENT_SCOPE	403	Bu işlem için yetersiz izin	Gerekli role sahip bir hesap kullandığınızı doğrulayın

Tenant

Kod	HTTP	Anlam	Çözüm
TENANT_NOT_FOUND	404	Bu kullanıcı için tenant hesabı mevcut değil	app.aether365.io adresinden hesap oluşturun
TENANT_NOT_CONNECTED	400	Microsoft 365 yönetici onayı tamamlanmamış	Ayarlar > Bağlantılar bölümünden bir tenant bağlayın

Taramalar

Kod	HTTP	Anlam	Çözüm
SCAN_NOT_FOUND	404	Tarama kimliği mevcut değil veya başka bir tenant'a ait	Tarama kimliğini kontrol edin
SCAN_ALREADY_RUNNING	409	Bu tenant için bir tarama zaten devam ediyor	Mevcut taramanın tamamlanmasını bekleyin
SCAN_PLAN_LIMIT_REACHED	429	Tarama kotası tükenmiş	Bir sonraki fatura dönemini bekleyin veya destek ile iletişime geçin
SERVICE_UNAVAILABLE	503	Platform bakım modunda	Durumu kontrol edin ve bakım bittiğinde tekrar deneyin

Bağlantılar

Kod	HTTP	Anlam	Çözüm
CONNECTION_NOT_FOUND	404	Bağlantı kimliği mevcut değil	Bağlantı kimliğini kontrol edin
CANNOT_REMOVE_LAST_CONNECTION	409	Kalan tek bağlantı kaldırılamaz	Bu bağlantıyı kaldırmadan önce başka bir bağlantı ekleyin

Ekip Üyeleri

Kod	HTTP	Anlam	Çözüm
MEMBER_LIMIT_REACHED	429	Üye limiti aşıldı	Daha fazla üye eklemek için destek ile iletişime geçin
MEMBER_ALREADY_EXISTS	409	E-posta zaten aktif veya bekleyen bir davete sahip	Mevcut üye listesini kontrol edin

Zamanlanmış Taramalar

Kod	HTTP	Anlam	Çözüm
SCAN_PLAN_LIMIT_REACHED	429	Özel zamanlama limiti aşıldı	Mevcut bir zamanlamayı silin veya destek ile iletişime geçin

Doğrulama

Kod	HTTP	Anlam
VALIDATION_ERROR	400	İstek gövdesi veya sorgu parametresi geçersiz. details alanı geçersiz alanları listeler.

Sunucu Hataları

Kod	HTTP	Anlam	Çözüm
INTERNAL_ERROR	500	Beklenmeyen sunucu hatası	İsteği tekrar deneyin. Hata devam ederse yanıt başlıklarındaki istek kimliğiyle destek ile iletişime geçin.

Hız Sınırları

API hız sınırını aştığınızda API şunu döndürür:

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Retry after 60 seconds."
  }
}

HTTP durumu: 429 Too Many Requests Başlık: Retry-After: 60

Mevcut hız sınırları: API anahtarı başına dakikada 120 istek.