Kimlik doğrulama
N11'de her istek mağazaya ait iki değerle doğrulanır: API Anahtarı (appKey) ve API Şifresi (appSecret). Değerler N11 Mağaza Paneli'nde Hesabım > API Hesapları bölümünden oluşturulur ve mağazanın kayıtlı e-posta adresine gönderilir.
REST servislerinde bu iki değer HTTP başlığı olarak gider; ayrı bir token alma adımı yoktur. SOAP servislerinde aynı değerler istek gövdesindeki auth bloğuna yazılır. Kategori servisleri 15 Ağustos 2025'ten beri anahtarsız çalışmıyor.
Ayrıntı: N11 API kimlik doğrulama.
Temel adres ve servis türleri
Bütün servisler api.n11.com alan adındadır. Yol önekine göre üç aile vardır:
| Önek | Tür | Örnek işlemler |
|---|---|---|
| /ms/... | REST, JSON | Ürün yükleme, güncelleme, fiyat-stok, silme, ürün sorgulama, task detayı |
| /cdn/... | REST, JSON | Kategori ağacı, kategori özellikleri |
| /rest/... | REST, JSON | Sipariş listeleme, sipariş onayı, paket bölme, toplama talebi |
| /ws/... | SOAP, XML | Ürün soruları, iade talepleri, parçalı iptal, fatura linki, katalog arama |
Ürün tarafındaki yazma işlemleri senkron değildir. İstek bir görev (task) olarak sıraya girer, yanıtta bir görev numarası döner. Sonucu ayrıca sorgularsınız.
Ortamlar ve sürümler
N11'in geliştirici sitesinde herkese açık bir test (sandbox) ortamı anlatılmıyor. Dokümandaki bütün örnekler canlı adresi kullanır. Bu yüzden ilk denemeleri az sayıda ürünle ve kolayca geri alınabilecek işlemlerle yapın.
Servislerde URL içinde sürüm numarası yalnız sipariş tarafında görünür (örneğin /rest/delivery/v1/). Değişiklikler geliştirici sitesindeki Change Log sayfasında duyurulur. Kapatılan SOAP metotları da bu sayfada listelenir.
İstek sınırları
N11 sınırları servis bazında belirtir. Dokümanda yazanlar şunlardır:
| Servis | Sınır |
|---|---|
| Sipariş listeleme | Dakikada en fazla 1.000 istek, sayfa başına en fazla 100 paket |
| Ürün yükleme, güncelleme, fiyat-stok, silme | İstek başına en fazla 1.000 SKU |
| Satıcı ürün sorgulama | Sayfa başına en fazla 250 ürün |
| Ürün soruları listeleme | Dakikada 1 kez |
Ayrıntı: N11 API istek sınırları.
Genel hata yapısı
REST görev servisleri hatayı iki katmanda verir. Görev hiç işlenmezse yanıtın status alanı REJECT olur ve nedenler reasons listesinde yazar. Görev işlenir ama tek tek ürünler başarısız olursa bunu ancak task detayından görürsünüz: her SKU için SUCCESS ya da FAIL ve bir neden metni döner.
SOAP servislerinde result.status alanı success ya da failure döner; hata metni aynı blokta gelir. N11'in yaygın hata mesajlarını çözümleriyle birlikte N11 API hata mesajları sayfasında topladık.
N11 API işlemleri
Genel
Ürün ve katalog
Stok ve fiyat
Sipariş
Sık sorulanlar
N11 API ücretli mi?
N11, API erişimi için ayrı bir ücret duyurmuyor. API hesabı mağaza panelinden açılır. Satıştan alınan komisyon ve hizmet bedelleri API kullanımından bağımsızdır.
N11 hâlâ SOAP mı kullanıyor?
Kısmen. Ürün, stok-fiyat ve sipariş servisleri REST'e taşındı; eski SOAP ürün ve stok metotları Ocak 2025'te kapatıldı. Ürün soruları, iade talepleri, parçalı iptal, fatura linki ve katalog arama ise SOAP olarak sunuluyor.
N11 API'de test ortamı var mı?
N11'in geliştirici dokümantasyonunda herkese açık bir test ortamı anlatılmıyor. Örnekler canlı api.n11.com adresini kullanıyor. Denemeleri az ürünle ve geri alınabilir işlemlerle yapmak gerekir.
N11 entegrasyonu için yazılım bilmek gerekir mi?
Kendi entegrasyonunuzu yazacaksanız evet: JSON ile REST, XML ile SOAP istekleri hazırlamanız gerekir. Hazır bir entegrasyon yazılımı kullanıyorsanız yalnız App Key ve App Secret değerlerini girmeniz yeterlidir.