Adım adım API hesabı açma
N11, API anahtarını mağaza panelinden kendiniz oluşturmanıza izin verir. Destek talebi açmanız gerekmez. Sıra şöyledir:
| Adım | Nerede | Ne olur |
|---|---|---|
| 1 | so.n11.com adresinden Mağaza Paneli'ne giriş | Mağaza hesabınızla oturum açarsınız |
| 2 | Hesabım > API Hesapları | Mevcut API hesapları listelenir |
| 3 | "Yeni Hesap Oluştur" düğmesi | Yeni bir API hesabı ve anahtarı üretilir |
| 4 | Mağazanın kayıtlı e-posta kutusu | App Key ve App Secret e-postayla gelir |
| 5 | Entegrasyon yazılımı ya da kendi kodunuz | İki değer bağlantı ayarına girilir |
N11'in yardım merkezine göre bu adım, mağaza hesabına yüklediğiniz evrakların süreci tamamlandıktan sonra açılır. Evrak onayı bekleyen yeni bir mağazada menü görünse bile hesap oluşturulamayabilir.
App Key ve App Secret ne işe yarar?
App Key mağazanızı tanıtan anahtardır. App Secret ise bu anahtarın şifresidir. N11 iki değeri birlikte kontrol eder ve isteği yalnız o mağazanın verisine bağlar. Böylece bir anahtar başka bir mağazanın ürününü ya da siparişini göremez.
REST servislerinde iki değer HTTP başlığı olarak gönderilir. SOAP servislerinde aynı değerler XML gövdesindeki auth bloğuna yazılır. Ayrı bir oturum açma ya da token alma adımı yoktur. Ayrıntılar için N11 API kimlik doğrulama sayfasına bakın.
Şifreyi yenilemek
N11'in eski referans dokümanına göre API şifresi istenirse yeniden oluşturulabilir, API hesabı da silinebilir. Şifreyi yenilediğinizde eski şifre geçersiz olur. Bu yüzden yenilemeden önce anahtarı kullanan bütün yazılımları listeleyin ve yeni değeri hepsine aynı anda girin.
Güvenli saklama ve sık yapılan hatalar
- E-postayı silmek: Değerler panelde açık metin olarak durmayabilir. E-postayı güvenli bir yerde saklayın ya da değerleri bir parola yöneticisine taşıyın.
- Baştaki ve sondaki boşluk: E-postadan kopyalarken satır sonu ya da boşluk eklenebilir. Bazı servisler bu boşluğu tolere eder, bazıları kimlik doğrulamayı reddeder. Yapıştırdıktan sonra değeri kırpın.
- Key ile Secret'ı karıştırmak: İki alan da uzun bir karakter dizisidir. Yer değiştirdiklerinde hata mesajı genelde yalnız "doğrulama başarısız" der.
- Anahtarı paylaşmak: App Secret'ı destek yazışmalarında, ekran görüntülerinde ya da kod deposunda açık bırakmayın. Sızdığını düşünüyorsanız şifreyi hemen yenileyin.
- Her yazılıma aynı hesap: Birden fazla entegrasyon kullanıyorsanız ayrı API hesapları açmak, birini kapatırken diğerini bozmamanızı sağlar.
Örneklerde gerçek değer yerine APP_KEY ve APP_SECRET gibi yer tutucular kullanın.
Bağlantıyı doğrulamanın en kolay yolu
Anahtarı aldıktan sonra yazma işlemi yapmayan bir istekle test edin. Satıcı ürün sorgulama servisi bunun için uygundur: GET https://api.n11.com/ms/product-query adresine page=0 ve size=1 parametreleriyle istek atın. Başlıklarda appKey ve appSecret olsun.
Yanıt 200 döner ve içinde totalElements alanı varsa anahtar çalışıyor demektir. Mağazada hiç ürün yoksa totalElements sıfır olur; bu da başarılı bir sonuçtur. Yetki hatası alırsanız önce boşluk ve yer değiştirme hatalarını kontrol edin.
Sık sorulanlar
N11 API anahtarı nereden alınır?
N11 Mağaza Paneli'nde Hesabım > API Hesapları bölümünden. "Yeni Hesap Oluştur" ile hesap açılır, App Key ve App Secret mağazanın kayıtlı e-posta adresine gönderilir.
N11 API anahtarı için başvuru gerekir mi?
Ayrı bir başvuru gerekmez. Ancak mağaza evraklarının onay süreci tamamlanmış olmalıdır. Süreç bitmeden API hesabı oluşturulamayabilir.
App Secret'ı kaybettim, ne yapmalıyım?
API Hesapları bölümünden şifreyi yeniden oluşturun. Yeni şifre e-postayla gelir. Eski şifre çalışmayacağı için anahtarı kullanan tüm yazılımlara yeni değeri girin.
Bir mağazada birden fazla API hesabı açılabilir mi?
API Hesapları bölümü hesapları liste olarak gösterir ve yeni hesap oluşturmaya izin verir. Farklı yazılımlar için ayrı hesap kullanmak, birini kapatırken diğerini etkilemez. Güncel üst sınırı panelde kontrol edin.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı