Hatalar ve Limitler
Hata kodları, origin doğrulama, hız sınırı
Public API'nin hata kodları, erişim kuralları ve hız sınırları.
Erişim kuralları
Her public istek iki şekilde doğrulanabilir:
| Yöntem | Ne zaman | Nasıl |
|---|---|---|
| Origin doğrulaması | Tarayıcıdan gelen istekler | İsteğin Origin / Referer başlığı, sitenin doğrulanmış alan adıyla karşılaştırılır |
| API anahtarı | Origin başlığı olmayan istekler (mobil, sunucu) | x-selwise-api-key başlığı ve scope kontrolü |
Site Key tek başına yetki vermez; her zaman bu ikisinden biriyle birlikte doğrulanır.
Hata kodları
| Kod | Anlamı | Sık sebebi |
|---|---|---|
404 | Site bulunamadı | Site Key yanlış ya da site silinmiş |
403 Site not verified | Domain doğrulanmamış | Doğrulama adımı tamamlanmamış |
403 Origin validation failed | İstek başka bir alan adından geliyor | Alan adı takma adı tanımlanmamış |
403 Invalid API key or insufficient scope | Anahtar geçersiz ya da yetkisi yetmiyor | Mobilde en sık: anahtarda mobile_write yok |
400 | İstek gövdesi geçersiz | Fazladan alan gönderilmiş olabilir |
429 | Hız sınırı aşıldı | Çok sık istek |
400 hatası — fazladan alan
Sunucu, tanımadığı bir alan içeren istekleri reddeder. Gövdeye kendi ek alanlarınızı eklemek 400 döndürür.
Sessizce yok sayılmaz
Birçok API bilmediği alanları yok sayar; bu API saymaz. Bir alanı yanlış yazmak (productCode yerine product_code) tüm isteği başarısız kılar. Hata mesajı hangi alanın sorunlu olduğunu söyler.
localhost
Yerel geliştirme adresinden gelen istekler üretimde kabul edilmez. Bu kapatılamaz: kabul edilseydi herhangi biri kendi makinesinden sizin sitenizin adına veri gönderebilirdi.
Yerel geliştirme için ayrı bir test sitesi tanımlayın.
Hız sınırları
Standart public uç noktalar dakika başına sınırlıdır. Sınırlar ortam yapılandırmasına bağlıdır; varsayılan standart sınır dakikada 100 istektir.
Bazı kritik uç noktalar hız sınırının dışındadır: kimliklendirme ve kullanıcı özellikleri, veri kaybını önlemek için sınırlanmaz.
429 alırsanız
| Sebep | Çözüm |
|---|---|
| Olayları tek tek gönderiyorsunuz | Toplu uç noktayı kullanın (events/batch) |
| Döngü içinde istek | İstekleri gruplayın |
| Sunucu tarafı toplu iş | İstekleri zamana yayın |
Widget bu sınırlara zaten uyar; sorun genellikle kendi yazdığınız sunucu tarafı entegrasyonlarda çıkar.
Kimlik uzunluğu
Müşteri kimliği en fazla 64 karakterdir. Daha uzunu 400 ile reddedilir. Ayrıntı: Kullanıcı Kimliklendirme.
Zaman aşımı
Uzun süren istekler zaman aşımına uğrar. Veri aktarımı gibi büyük işlemler için satır içi gönderimde istek başına 1000 kayıt sınırı vardır — bkz. Veriyi Hazırlama.
Son güncelleme: 9 Eylül 2026