REST servislerinde başlıklar
N11'in REST dokümanındaki her serviste aynı not yer alır: Authorization alanında "no auth" seçilir, başlıklara appKey ve appSecret eklenir. İstek gövdesi JSON'dur. Basit bir başlık seti şöyle görünür:
| Başlık | Örnek değer | Not |
|---|---|---|
| appKey | APP_KEY | Mağaza panelinde üretilen API Anahtarı |
| appSecret | APP_SECRET | E-postayla gelen API Şifresi |
| Content-Type | application/json | POST ve PUT isteklerinde |
HTTP başlık adları büyük-küçük harfe duyarlı değildir. Yani appkey ya da APPKEY yazmak da aynı başlığı gönderir. Değerin kendisi ise birebir aynı olmalıdır.
SOAP servislerinde auth bloğu
Ürün soruları, iade talepleri ve parçalı iptal gibi SOAP servislerinde başlık kullanılmaz. Değerler isteğin içinde, işlem elemanının ilk çocuğu olarak gönderilir. Yapı şöyledir:
- Zarf: soapenv:Envelope, ad alanı xmlns:sch="http://www.n11.com/ws/schemas"
- İşlem elemanı: örneğin sch:GetProductQuestionListRequest
- İlk çocuk: auth, içinde appKey ve appSecret
- Sonra işleme özgü alanlar: örneğin productQuestionSearch ve pagingData
SOAP yanıtında result.status alanı success ya da failure döner. Kimlik reddedildiğinde de HTTP kodu çoğu zaman 200 olabilir; bu yüzden yalnız HTTP koduna değil, result.status alanına bakın.
Kategori servislerindeki kural değişikliği
Kategori ağacı ve kategori özellikleri servisleri bir süre anahtarsız çağrılabiliyordu. N11 Change Log'unda duyurulduğu üzere 15 Ağustos 2025'ten beri bu servisler de API Key ve Secret olmadan çalışmıyor. Eski bir entegrasyon kategori listesini başlıksız çekiyorsa bu tarihten sonra hata almaya başlamıştır.
Güncel kategori dokümanında başlık olarak appKey'in eklenmesi gerektiği yazar. Change Log ise Key ile Secret'ın birlikte gerektiğini söyler. En güvenli yol, kategori isteklerinde de iki başlığı birlikte göndermektir.
Sık karşılaşılan bağlantı sorunları
- Değerde boşluk: Kopyalarken eklenen boşluk, özellikle SOAP gövdesinde doğrulamayı bozabilir. Değeri her zaman kırpın.
- Yer değişmiş değerler: Key ile Secret'ın yeri değişirse servis yalnız "doğrulama başarısız" benzeri bir mesaj verir.
- Yenilenmiş şifre: Panelden şifreyi yenilediyseniz eski şifreyle yapılan bütün istekler reddedilir.
- Bağlantı kopması: Bazı HTTP istemcileri api.n11.com ile TLS el sıkışmasında bağlantıyı ECONNRESET ile kaybedebilir. Bu bir yetki hatası değildir; aşağıdaki nota bakın.
- XML'de özel karakter: SOAP gövdesine yazdığınız metinde & ve < gibi karakterler kaçış karakteriyle yazılmalıdır. Aksi hâlde istek geçersiz XML olur.
Sık sorulanlar
N11 API'de Bearer token var mı?
Hayır. N11 REST servisleri token kullanmaz. Her istekte appKey ve appSecret başlıkları gönderilir; dokümanda Authorization alanı için "no auth" seçilmesi istenir.
Başlık adı appKey mi, appkey mi olmalı?
HTTP başlık adları büyük-küçük harfe duyarsızdır, ikisi de aynı başlıktır. Dokümanda appKey ve appSecret yazımı kullanılır. Değerlerin kendisi ise birebir doğru olmalıdır.
Kategori servisini anahtarsız çağırabilir miyim?
Artık hayır. N11, 15 Ağustos 2025'ten itibaren kategori servislerinin API Key ve Secret olmadan çalışmayacağını duyurdu. İki başlığı da gönderin.
REST çalışıyor ama SOAP doğrulama hatası veriyor, neden?
En sık neden değerlerdeki gizli boşluk ya da XML kaçış sorunudur. auth bloğundaki appKey ve appSecret değerlerini kırpın ve özel karakterleri kaçış karakteriyle yazın.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı