Hata Kodları

DiscoWeb Activity'de karşılaştığın hata kodunu aşağıdan aratabilirsin. Her kod için olası nedenler ve çözüm adımları listelenmiştir.

Hızlı Başvuru Tablosu

Kod	Başlık	Kategori
DW-1001	frame_id Bulunamadı	Kimlik Doğrulama
DW-1002	SDK Zaman Aşımı	Kimlik Doğrulama
DW-1003	Client ID Tanımlı Değil	Kimlik Doğrulama
DW-1004	SDK Kimlik Doğrulaması Başarısız	Kimlik Doğrulama
DW-1005	OAuth Token Alınamadı	Kimlik Doğrulama
DW-2001	Sunucu Kayıtlı Değil	Sunucu Yapılandırması
DW-2002	Kurulum Tamamlanmamış	Sunucu Yapılandırması
DW-2003	Bot Sunucuda Bulunamıyor	Sunucu Yapılandırması
DW-2004	Discord API Hatası	Sunucu Yapılandırması
DW-2005	Servis Anahtarı Eksik	Sunucu Yapılandırması
DW-2006	Bot Token Eksik	Sunucu Yapılandırması
DW-3001	Oturum Geçersiz	Kullanıcı / Yetki
DW-3002	Sunucu Üyesi Değilsin	Kullanıcı / Yetki
DW-3003	Kullanıcı Profili Bulunamadı	Kullanıcı / Yetki
DW-3004	Gerekli Rol Eksik	Kullanıcı / Yetki
DW-3005	Yetersiz Yetki	Kullanıcı / Yetki
DW-4001	Yüksek Ekonomi Gerekli	Ekonomi
DW-4002	Yetersiz Bakiye	Ekonomi
DW-4003	Günlük Transfer Limiti	Ekonomi
DW-5001	Sunucuya Bağlanılamadı	Ağ / API
DW-5002	API Yanıt Vermedi	Ağ / API
DW-5003	Geçersiz API Yanıtı	Ağ / API
DW-9001	Beklenmeyen JavaScript Hatası	Bilinmeyen
DW-9002	İşlenmeyen Promise Hatası	Bilinmeyen
DW-9003	Bilinmeyen Hata	Bilinmeyen

Kimlik Doğrulama

DW-1xxx

Discord Activity başlatılırken yaşanan oturum ve yetkilendirme sorunları.

frame_id Bulunamadı

Discord frame_id parametresi bulunamadı.

Olası Nedenler

Activity normal bir tarayıcıdan açılmaya çalışıldı (Discord dışı).
URL'de frame_id parametresi eksik; Discord bunu Activity başlarken otomatik ekler.
Çok eski veya desteklenmeyen bir Discord istemcisi kullanılıyor.

Çözüm

✓Activity'yi Discord masaüstü veya mobil uygulaması üzerinden aç.
✓Discord uygulamasını güncelleyerek tekrar dene.
✓Pencereyi kapatıp yeniden aç.

SDK Zaman Aşımı

Authentication timeout.

Olası Nedenler

Discord SDK 90 saniye içinde hazır hale gelemedi.
İnternet bağlantısı yavaş veya kesintili.
Discord sunucuları geçici olarak yüksek yük altında.

Çözüm

✓Activity penceresini kapatıp tekrar aç.
✓İnternet bağlantını kontrol et.
✓Birkaç dakika bekleyip tekrar dene.

Client ID Tanımlı Değil

Discord Client ID tanımlı değil (NEXT_PUBLIC_DISCORD_CLIENT_ID).

Olası Nedenler

Sunucu yapılandırmasında NEXT_PUBLIC_DISCORD_CLIENT_ID ortam değişkeni eksik.
Bu bir geliştirici/dağıtım hatasıdır, kullanıcı kaynaklı değildir.

Çözüm

✓Ekrandaki Bildir butonuna basarak geliştiriciyi haberdar et.

SDK Kimlik Doğrulaması Başarısız

Discord yetkilendirmesi başarısız.

Olası Nedenler

Discord OAuth akışı tamamlanamadı.
Kullanıcı izin penceresini kapattı veya reddetti.
Discord API geçici bir hata döndürdü.
Backend auth endpoint'e ulaşılamadı.

Çözüm

✓Activity penceresini kapatıp tekrar aç; izin ekranı gelirse onayla.
✓İnternet bağlantını kontrol et.
✓Birkaç dakika bekleyip tekrar dene.

OAuth Token Alınamadı

Discord OAuth token alınamadı.

Olası Nedenler

Discord token exchange adımı başarısız oldu.
Backend ile Discord arasındaki iletişimde sorun var.

Çözüm

✓Activity'yi yeniden aç.
✓Sorun devam ederse geliştiriciyi bildir.

Sunucu Yapılandırması

DW-2xxx

Discord sunucusunun DiscoWeb sistemine kayıt ve kurulum sorunları. Genellikle yönetici müdahalesi gerekir.

Sunucu Kayıtlı Değil

Sunucu sisteme kayıtlı değil. Yönetici kurulum yapmalı.

Olası Nedenler

Discord sunucusu DiscoWeb sistemine hiç kaydedilmemiş.
Yönetici setup adımlarını henüz tamamlamamış.

Çözüm

✓Yöneticiler için: discoweb.tech adresine git ve sunucunu kaydet.
✓Üyeler için: Sunucu yöneticinize bu hatayı bildirin.

Kurulum Tamamlanmamış

Sunucu kurulumu tamamlanmamış. Yönetici setup'ı bitirmeli.

Olası Nedenler

Sunucu sisteme kayıtlı ama kurulum tamamlanmamış.
Yönetici kurulum sürecini yarıda bırakmış.

Çözüm

✓Yöneticiler için: discoweb.tech adresine git ve kurulumu tamamla.
✓Üyeler için: Sunucu yöneticinize bu hatayı bildirin.

Bot Sunucuda Bulunamıyor

Bot sunucuda bulunamıyor. Yönetici botu yeniden davet etmeli.

Olası Nedenler

DiscoWeb botu sunucudan çıkarılmış veya hiç eklenmemiş.
Bot sunucuda bulunuyor ama yetkileri kaldırılmış.

Çözüm

✓Yöneticiler için: Botu sunucuya yeniden davet et ve gerekli yetkileri (Rolleri Yönet, Mesaj Gönder) ver.
✓Üyeler için: Sunucu yöneticinize bu hatayı bildirin.

Discord API Hatası

Discord API geçici hata verdi. Birkaç dakika sonra tekrar dene.

Olası Nedenler

Discord'un kendi API'si geçici olarak çalışmıyor.
discordstatus.com'da aktif bir olay var.

Çözüm

✓Birkaç dakika bekleyip tekrar dene.
✓discordstatus.com adresini kontrol et.

Servis Anahtarı Eksik

Sunucu yapılandırması eksik (servis anahtarı).

Olası Nedenler

SUPABASE_SERVICE_ROLE_KEY ortam değişkeni eksik veya hatalı.
Bu bir sunucu tarafı yapılandırma hatasıdır.

Çözüm

✓Ekrandaki Bildir butonuna basarak geliştiriciyi haberdar et.

Bot Token Eksik

Bot token yapılandırması eksik.

Olası Nedenler

DISCORD_BOT_TOKEN ortam değişkeni sunucu tarafında tanımlı değil.
Bu bir geliştirici/dağıtım hatasıdır.

Çözüm

✓Ekrandaki Bildir butonuna basarak geliştiriciyi haberdar et.

Kullanıcı / Yetki

DW-3xxx

Kullanıcı hesabı, oturum ve izin sorunları.

Oturum Geçersiz

Oturum geçersiz veya süresi dolmuş. Yeniden giriş gerekiyor.

Olası Nedenler

Oturum çerezi süresi dolmuş.
Oturum verisi bozulmuş veya silinmiş.
Activity çok uzun süre açık kaldı.

Çözüm

✓Activity penceresini kapatıp yeniden aç; otomatik olarak yeniden giriş yapılır.
✓Oturumu Sıfırla butonuna basarak tüm session verilerini temizle.

Sunucu Üyesi Değilsin

Bu sunucuda üye değilsin.

Olası Nedenler

Discord hesabın bu sunucudan çıkarılmış veya hiç katılmamış.
Activity farklı bir hesapla açılmaya çalışılıyor.

Çözüm

✓Önce Discord'da bu sunucuya üye olduğundan emin ol.
✓Doğru Discord hesabınla giriş yaptığını kontrol et.

Kullanıcı Profili Bulunamadı

Kullanıcı profili bulunamadı.

Olası Nedenler

Bu sunucu için henüz bir DiscoWeb profili oluşturulmamış.
Profil verisi sistemden silinmiş.

Çözüm

✓İlk kez giriyorsan profil oluşturma ekranı otomatik açılır; formu doldur.
✓Sorun devam ederse Activity'yi yeniden aç.

Gerekli Rol Eksik

Bu özellik için gerekli rol eksik.

Olası Nedenler

Bu özelliği kullanmak için gereken Discord rolüne sahip değilsin.
Sunucu yöneticisi bu özelliği belirli rollerle kısıtlamış.

Çözüm

✓Sunucu yöneticinizden gerekli rolü talep edin.

Yetersiz Yetki

Bu işlem için yetkin yok.

Olası Nedenler

İşlem için gereken sunucu iznine sahip değilsin.
Yönetici paneline üye olarak erişmeye çalışıyorsun.

Çözüm

✓Sunucu yöneticinizle iletişime geçin.

Ekonomi

DW-4xxx

Ekonomi sistemi ile ilgili işlem ve bakiye hataları.

Yüksek Ekonomi Gerekli

Bu özellik yüksek ekonomi gerektiriyor.

Olası Nedenler

Erişmeye çalıştığın özellik (Borsa, Hazine, Piyasa vb.) sunucunun yüksek ekonomi planında olmasını gerektiriyor.
Sunucu hâlâ temel ekonomi planında.

Çözüm

✓Sunucu yöneticinizden Yüksek Ekonomi başvurusu yapmasını isteyin.
✓Yöneticiyseniz sol menüdeki Yüksek Ekonomi Başvurusu bölümünden başvuru yapabilirsiniz.

Yetersiz Bakiye

İşlem bakiyeniz yetersiz.

Olası Nedenler

Yapmak istediğin işlem için yeterli bakiyen yok.

Çözüm

✓Bakiyeni kontrol et.
✓Kazanma yollarını (check-in, mesaj, ses vb.) kullanarak bakiye topla.

Günlük Transfer Limiti

Günlük transfer limitine ulaşıldı.

Olası Nedenler

24 saat içinde transfer yapabileceğin maksimum miktara ulaştın.

Çözüm

✓24 saat bekle ve tekrar dene.

Ağ / API

DW-5xxx

İnternet bağlantısı ve API iletişim hataları.

Sunucuya Bağlanılamadı

Sunucuya bağlanılamadı. İnternet bağlantını kontrol et.

Olası Nedenler

İnternet bağlantısı yok veya çok yavaş.
DiscoWeb sunucuları geçici olarak erişilemez durumda.

Çözüm

✓İnternet bağlantını kontrol et.
✓Birkaç saniye bekleyip tekrar dene.

API Yanıt Vermedi

API yanıt vermedi. Sunucu geçici olarak meşgul olabilir.

Olası Nedenler

DiscoWeb API sunucusu yüksek yük altında.
İstek zaman aşımına uğradı.

Çözüm

✓Birkaç saniye bekleyip tekrar dene.
✓Sorun devam ederse geliştiriciyi bildir.

Geçersiz API Yanıtı

Geçersiz API yanıtı alındı.

Olası Nedenler

API beklenmeyen formatta yanıt döndürdü.
Muhtemelen bir deploy veya versiyon uyumsuzluğu.

Çözüm

✓Sayfayı yenile veya Activity'yi yeniden aç.
✓Sorun devam ederse geliştiriciyi bildir.

Bilinmeyen

DW-9xxx

Sistemin otomatik olarak yakaladığı beklenmedik hatalar. Ekranda 'Arka planda bir hata oluştu' bildirimi gösterir.

Beklenmeyen JavaScript Hatası

Beklenmeyen bir JavaScript hatası oluştu.

Olası Nedenler

Uygulama kodunda beklenmedik bir durum oluştu.
Tarayıcı veya Discord istemci uyumsuzluğu.

Çözüm

✓Bildirimi gördüğünde Geliştiricide Bildir butonuna bas.
✓Activity'yi yeniden aç.

İşlenmeyen Promise Hatası

İşlenmeyen bir Promise hatası oluştu.

Olası Nedenler

Bir ağ isteği veya asenkron işlem beklenmedik şekilde başarısız oldu.

Çözüm

✓Bildirimi gördüğünde Geliştiricide Bildir butonuna bas.
✓Activity'yi yeniden aç.

Bilinmeyen Hata

Bilinmeyen bir hata oluştu.

Olası Nedenler

Hata kaynağı belirlenemedi.

Çözüm

✓Geliştiricide Bildir butonuna basarak geliştiriciyi haberdar et.
✓Activity'yi yeniden aç.

Hata mı yaşıyorsun?

Activity ekranındaki Bildir butonuna basarak hata detaylarını otomatik olarak bize iletebilirsin. Eğer butona erişemiyorsan, hata kodunu (örn. DW-1004) Discord sunucusundaki destek kanalına yazabilirsin.