GET https://api.n11.com/ms/product-query
- Authorization no auth seçiniz.
- Headers alanına appKey ve appSecret bilgisini eklemeniz gerekir.
- HTTP isteğinizi GET methoduyla ilgili endpoint’e gönderin.
Dikkat Edilmesi Gerekenler;
- Request parametrelerinde zorunluluk yer almamaktadır, parametreler boş olacak şekilde listeleme yapabilirsiniz. Hiçbir parametre girilmediğinde satıcının tüm ürünleri page 0 size 20 olacak şekilde listelenecektir.
- stockCode parametresi her istekte tek bir değer alabilmektedir, birden fazla ürün listelemek için satıcı stok kodu bazlı istek atmanız gerekmektedir.
- Pagination yapısı kullanıyorsanız page 0 başlatıp, Response Body’de dönen totalPages alanını dikkate alarak content boş dönen sayfayı son sayfa olarak belirleyebilirsiniz.
- Response Body içerisindeki parametre değerleri karakter sayısı ve veri tipleri ürün sayısının doğal artışıyla beraber değişebilmektedir ( Örneğin n11ProductId alanı 9 haneden 10 haneye çıkabilir, entegratör üzerinde tanımlama yapılırken bu durumlar göz önünde bulundurulması sağlıklı olacaktır ).
| Parametre | Parametre Değer | Açıklama | Tip |
| id | n11 Ürün Kodu | n11 Ürün kodu ile listeleme | long |
| productMainId | Grup Kodu | Ürün grup kodu ile listeleme | string |
| stockCode | Satıcı Ürün Kodu | Satıcı ürün kodu ile listeleme | string |
| saleStatus | On_Sale : Satışta Out_Of_Stock : Stokta Yok |
Ürün satış durumuna göre listeleme | string |
| productStatus | Active : Onaylı InCatalogApproval : Katalog Onay Sürecinde Suspended : Beklemede CatalogRejected : Katalogdan Reddedildi Prohibited : Yasaklı Unlisted : Limit Dışı InApproval : Aksiyon Bekleyen |
Ürün onay durumuna göre listeleme | string |
| brandName | Marka ismi | N11 Satıcı panelinde yer alan ürünleri marka ismine göre listelemesini sağlar | string |
| categoryIds | Kategori ID bilgisi | Kategori ID ile listeleme | long list |
| page | Varsayılan 0 | int | |
| size | Varsayılan 20 maksimum 250 | int | |
| sender | SELLER : Satıcı gönderir N11 : n11 Depo Gönderir ALL : Tümü |
Sorgulamada kullanılabilecek gönderici tipi, gönderilmediği taktirde default değer “SELLER” olarak alınır. | string |
| Parametre (Cevap) | Açıklama |
| n11ProductId | N11 Ürün Kodu |
| sellerId | Mağaza ID |
| sellerNickname | Mağaza Adı |
| stockCode | Satıcı Stok Kodu |
| title | Ürün Adı |
| description | Ürün açıklaması |
| categoryId | Kategori ID |
| productMainId | Model Kodu |
| status | Ürün Aktifliği |
| saleStatus | Satış Durumu |
| preparingDay | Kargo Hazırlık Süresi |
| shipmentTemplate | Kargo Şablonu |
| maxPurchaseQuantity | Maksimum Satın Alım Adedi |
| customTextOptions | Müşteriye Özel Ürün Seçeneği |
| catalogId | Ürün Katalog ID |
| barcode | Barkod |
| groupId | Ürün Katalog Grup ID |
| currencyType | Para Birimi |
| salePrice | Satış Fiyatı |
| listPrice | Liste Fiyatı |
| quantity | Stok Adedi |
| attributes | Ürün Özellikleri |
| imageUrls | Görsel Linkleri |
| vatRate | KDV Oranı |
| commissionRate | Komisyon Oranı |
| sender | Gönderici tipi; SELLER: Satıcı gönderir N11: n11 depo gönderir |
| totalElements | Toplam Ürün Sayısı |
| totalPages | Toplam Sayfa Sayısı |
| number | Mevcut Sayfa Numarası |
| numberOfElements | Sayfadaki Ürün Sayısı |
| size | Listelenen Ürün Adedi |
Örnek Request
GET https://api.n11.com/ms/product-query?id=&productMainId=&stockCode=&saleStatus=&productStatus=&brandName=&categoryIds=&page=&size=
Örnek Response
{
"content": [
{
"n11ProductId": 123456789,
"sellerId": 9876543,
"sellerNickname": testMagaza,
"stockCode": "TestSKU123",
"title": "Test Ürünü Kontrol Amaçlı Gri",
"description": "Açıklama bilgisi uzun açıklama",
"categoryId": 1231231,
"productMainId": "GrupKoduModellemeİçin",
"status": "Active",
"saleStatus": "On_Sale",
"preparingDay": 3,
"shipmentTemplate": "1",
"maxPurchaseQuantity": 5,
"customTextOptions": [],
"catalogId": 987654321,
"barcode": null,
"groupId": 12345678,
"currencyType": "TL",
"salePrice": 10000.0,
"listPrice": 10000,
"quantity": 2,
"attributes": [
{
"attributeId": 1,
"attributeName": "Marka",
"attributeValue": "Diğer"
},
{
"attributeId": 429,
"attributeName": "Renk",
"attributeValue": "Gri"
},
{
"attributeId": 845,
"attributeName": "Ölçüler",
"attributeValue": "0.5 CMx 1 M"
}
],
"imageUrls": [
"https://n11scdn3.akamaized.net/a1/org/07/76/32/73/IMG-4395477787604309691.jpg"
],
"vatRate": 10,
"commissionRate": 8,
"sender": "SELLER"
}
],
"pageable": {
"sort": null,
"pageNumber": 0,
"pageSize": 20,
"offset": 0,
"paged": true,
"unpaged": false
},
"last": true,
"totalElements": 1,
"totalPages": 1,
"first": true,
"number": 0,
"sort": null,
"numberOfElements": 1,
"size": 20,
"empty": false
}