Dokümanda yazan sınırlar
Aşağıdaki değerler N11 geliştirici sitesindeki servis sayfalarından alınmıştır. Yazmayan servisler için kesin bir sayı vermiyoruz.
| Servis | Sınır | Varsayılan |
|---|---|---|
| Sipariş listeleme (shipmentPackages) | Dakikada 1.000 istek, size en fazla 100 | Sayfa 0'dan başlar |
| Ürün yükleme, güncelleme, fiyat-stok, silme | İstek başına en fazla 1.000 SKU | Yanıtta görev numarası |
| Satıcı ürün sorgulama (product-query) | size en fazla 250 | page 0, size 20 |
| Task detay sorgulama | pageable.size ile sayfalı | Örnekte size 1000 |
| Ürün soruları listeleme (SOAP) | Dakikada 1 kez | status boşsa OPEN |
| İade talepleri listeleme (SOAP) | Sayfa başına 20 kayıt | status boşsa REQUESTED |
| Katalog arama (SOAP) | Parametre başına en fazla 10 değer | Ürün adı en az 10 karakter |
Tarih aralığı ve sayfalama kuralları
Sipariş listelemede tarih aralığı da bir sınırdır. Yalnız startDate verilirse sonraki 15 günün kayıtları gelir; yalnız endDate verilirse önceki 15 gün gelir. İki tarih arasında çok büyük fark varsa (dokümandaki örnekler 6 ay ve 2 yıl) servis endDate'ten önceki son 15 günü döndürür. Kasım 2024 öncesi sipariş verisi bu servisten hiç verilmez.
Sayfalamada N11 aynı yöntemi önerir: page 0'dan başlayın, yanıttaki totalPages alanına bakın ve content boş dönen sayfayı son sayfa sayın. Ürün ve sipariş sayısı arttıkça alan uzunlukları da değişebilir; örneğin ürün numarası 9 haneden 10 haneye çıkabilir. Veritabanında bu alanları dar tanımlamayın.
Test ortamı var mı?
N11'in geliştirici dokümantasyonunda herkese açık bir test ya da sandbox adresi anlatılmıyor. Bütün örnek istekler canlı https://api.n11.com adresini kullanır. Bu nedenle:
- İlk yükleme denemelerini tek bir ürünle yapın ve sonucu task detayından okuyun.
- Stok denemesinde satışta olmayan ya da sizin kontrolünüzdeki bir ürünü seçin.
- Fiyat denemesinde mevcut fiyatı not alın; yanlış bir değeri hemen geri yazabilmeniz gerekir.
- Sipariş onayı gibi geri alınamayan işlemleri gerçek bir siparişle, süreç oturduktan sonra deneyin.
Test ortamı ihtiyacınız varsa N11'in entegrasyon ekibine sellerintegration@n11.com adresinden sorabilirsiniz; bu adres Change Log duyurularında iletişim adresi olarak geçer.
Sınırlara takılmamak için
- Toplu stok ve fiyat değişikliklerini tek tek değil, görev başına yüzlerce SKU'luk paketlerle gönderin. Paket büyüdükçe yanıt süresi de uzayabilir; zaman aşımı görürseniz paketi küçültün.
- Soru listesini sık sorgulamayın. Sonucu en az bir dakika önbellekte tutun.
- Görev sonucunu sık aralıklarla sorgulamak yerine birkaç saniye bekleyerek kontrol edin.
- Ağ hatalarında (bağlantı kopması, zaman aşımı) artan bekleme süreleriyle yeniden deneyin; yetki ve doğrulama hatalarında yeniden denemek işe yaramaz.
Sık sorulanlar
N11 sipariş servisine dakikada kaç istek atılabilir?
Sipariş listeleme dokümanına göre dakikada en fazla 1.000 istek. Sayfa başına en fazla 100 paket listelenir.
N11'e tek seferde kaç ürünün stoğu gönderilir?
Fiyat-stok güncelleme görevi istek başına en fazla 1.000 SKU kabul eder. Büyük paketlerde yanıt süresi uzayabileceği için daha küçük paketler pratikte daha güvenlidir.
N11 soruları neden sık güncellenemiyor?
Soru listeleme servisi dakikada yalnız bir kez çağrılabilir. Daha sık istek atıldığında N11 uyarı mesajı döner.
Eski siparişleri API ile çekebilir miyim?
REST sipariş listeleme servisi Kasım 2024 öncesi sipariş verisini vermez. Daha eski kayıtlar için mağaza panelindeki raporları kullanmanız gerekir.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı