Bu sayfa, entegrasyonda karşılaşacağınız sorunları belirti, neden, çözüm üçlüsüyle listeler. Belirtiyi hata kodundan ya da durum kodundan bulun. Kod tablolarının tamamı için hata referansı.
Not
Sorun bildirirken şunları ekleyin: çağrılan yol ve yöntem, durum kodu ve gövde (gizli değerler çıkarılmış), istek zamanı (UTC) ve eklenti uçlarında x-request-id/requestId. Sunucu hata ayrıntısı dışarı sızdırmaz; bu bilgiler incelemeyi hızlandırır.
Authorization: Bearer crx_live_… başlığı yok ya da biçimi yanlış; anahtar iptal edilmiş, devre dışı ya da süresi dolmuş; anahtar başka ortama ait
Başlığı ve anahtarı kontrol edin; panelde anahtarın durumuna ve ortamına bakın (API anahtarları). Sunucu “yanlış anahtar” ile “iptal edilmiş“i ayırt etmez
Sunucu çağrısı 403 permission denied
İstemci anahtarıyla sunucu ucu çağırıyorsunuz
Sunucu anahtarı kullanın (uç noktalar: “Sunucu anahtarı” olan uçlar)
Oyuncu çağrısı 401
x-crx-env başlığı yok ya da UUID değil; oturum yok, süresi dolmuş ya da iptal; ortam uyuşmuyor
Başlığı ekleyin; oturumu yenileyin ya da yeniden giriş yapın. Yasaklı hesap da 401 görünür (ayrım yapılmaz)
Oyuncu 403 permission denied (POST)
CSRF çifti eksik/eşleşmiyor; jeton zaten kullanılmış; Origin izinli değil
Aşağıdaki CSRF satırlarına bakın
Girişte 403 ve {"code":"account_banned"}
Hesap yasaklı
Oyuncuya askı ekranı gösterin; yeniden deneme döngüsü kurmayın; yeni misafir açmayın
Oturum beklenenden önce bitiyor
30 gün hiç istek yapılmadı; ya da 180 günlük mutlak tavan doldu; parola değişti (tüm oturumlar düşer); ortamda “tek aktif oturum” açık ve başka cihazdan girildi
Yeniden giriş akışı kurun; davranış güvenlik sayfasında
Tarayıcıda oturum çerezi hiç kurulmuyor
HTTP üzerinden çalışıyorsunuz (Secure + __Secure- öneki); API başka bir alan adında (çerez üçüncü taraf olur, SameSite=Lax); tarayıcı çerezleri engelliyor
x-csrf-token başlığı ya da __Secure-crx.csrf çerezi gönderilmiyor
GET /v1/auth/csrf ile jeton alın; çerezi ve başlığı birlikte gönderin. SDK bunu otomatik yapar
İlk POST geçiyor, ikincisi 403
CSRF jetonu tek kullanımlıktır ve her başarılı yanıtla yenilenir; yanıtın yeni değerini saklamadınız ya da iki isteği aynı jetonla paralel gönderdiniz
Her yanıttaki yeni x-csrf-token ve Set-Cookie değerini kullanın; değiştirici istekleri sıraya koyun
Yalnız tarayıcıda 403, curl’de çalışıyor
Origin ortamın izinli kökenlerinde değil; Sec-Fetch-Site: cross-site ile gezinme isteği
Oyunun alan adını ortam alan adı olarak tanımlayın (Oyun ayarları: ortamlar); API’yi aynı kökenden çağırın
Tarayıcı konsolunda “CORS policy” hatası
Oyunun alan adı hiçbir ortamın alan adı listesinde ya da genel izinli listede değil (sunucu o origin’e CORS vermez); ya da https://<alan adı> dışında bir origin (http, port, null)
Alan adını ortam alan adı olarak ekleyin (Oyun ayarları: ortamlar); olmuyorsa aynı köken ters vekil kurun. Vekilinize ek CORS başlığı eklemeyin
Uç nokta kayıtlı değil, silinmiş ya da devre dışı; olay türü abone listesinde yok; webhooks modülü kapalı (teslimatlar yerinde bekler, veri silinmez); uç nokta herkese açık değil