API
English

API referansı · Ürünler

Ürün getir

Tek bir ürünü görselleri, varyantları ve özellikleriyle döndürür. Ürünü ProductId veya ProductSourceId + Code ile bulursunuz.

POST https://out.stockmount.com/api/Product/GetProduct
Ürün Paketi gerekir

ProductId 0'dan büyükse ürün yalnızca bu kimlikle, hesabınızın tüm kaynaklarında aranır; Code yok sayılır. ProductId yoksa Code ve ProductSourceId birlikte gerekir. İkisi de yoksa 00003 (ErrorMessage: ProductId), Code var ama kaynak yoksa 00003 (ErrorMessage: ProductSourceId) döner. Ürün bulunamazsa 70005 (Product was not found!) döner. Durdurulmuş ürünler (durum 3) de döner; kaldırılmış DeleteProduct ile silinmiş ürünler dönmez.

Varyantlar ve özellikler yalnızca ProductId ile sorguda yüklenir. Code ile sorguda Variants boş dizi gelir ve Specs yanıtta hiç yer almaz.

Variants, UpdateProduct ile pasife alınmış varyantları da içerir ve varyant durumu döndürülmez; varyantlar oluşturulma sırasıyla gelir.

Bazı alanlar okunmadığı için her zaman sabit değerle döner: Weight, StoreId, Price2–Price5 0; UpdateProductByCode ve SetProductQuantityFromVariants false; UpdateProductDescription true; varyantlarda CurrencyId, MinSalePrice ve Price2–Price5 0. VariantName5, VariantName6, VariantValue5, VariantValue6 ve Mpn döndürülmez. Değeri null olan alanlar yanıtta hiç yer almaz.

Aktif Ürün Paketi olmayan hesaplar 70018 hatası alır; paket bilgisi doğrulanamazsa 99999 döner.

İstek alanları

Alan Tip Açıklama
ApiCode zorunlu string DoLogin ile aldığınız oturum kodu.
ProductId integer Ürün kimliği. Gönderirseniz diğer alanlar yok sayılır.
Code string Ürün kodu. ProductId yoksa kullanılır; birebir eşleşir.
ProductSourceId integer Code ile sorguda zorunlu: kodun aranacağı kaynak.

Yanıt alanları (Response)

Alan Tip Açıklama
ProductId integer Ürün kimliği.
ProductSourceId integer Ürünün kaynağı.
Code string Ürün kodu.
Code2 string İkinci ürün kodu.
Name string Ürün adı.
Subtitle string Alt başlık.
Description string Açıklama (HTML, temizlenmiş).
Barcode string Barkod. Ürün için entegrasyon tarafında ikinci bir barkod tanımlıysa o döner.
Brand string Marka.
Model string Model.
Category string Kategori adı.
Price number Satış fiyatı.
MarketPrice number Piyasa (liste) fiyatı; yoksa 0.
CurrencyId integer Para birimi kimliği.
TaxRate number KDV oranı; yoksa 0.
Quantity integer Stok miktarı.
SoldCount integer Satış adedi.
Status integer Ürün durumu.
0
Değişmedi
1
Yeni (API ile eklenen ürünlerin ilk durumu)
2
Değişti (UpdateProduct sonrası, stok 0'dan büyükse)
3
Durduruldu / stok yok (StopProduct veya stok 1'den küçük)
4
Yeniden eklendi
Volume number Hacim / desi (ikinci değer tanımlıysa o).
Width number Genişlik.
Length number Uzunluk.
Height number Yükseklik.
Weight number Her zaman 0 (saklanan değer döndürülmez).
Url string Ürün sayfası adresi; yoksa boş.
CreationTime datetime Oluşturulma zamanı, saat dilimi eki olmadan (ör. 2025-11-05T10:22:31.497).
VariantName1 string 1. varyant özelliğinin adı (VariantName2–VariantName4 de döner; 5 ve 6 dönmez).
DispatchPeriod integer Kargoya teslim süresi (gün); -1 tanımsız.
SellerNote string Satıcı notu.
Images object[] Görseller, en fazla 12.
Images[]. Order integer 0'dan başlayan sıra.
Images[]. Url string Görsel adresi.
Variants object[] Varyantlar. Yalnızca ProductId ile sorguda dolar; pasif varyantlar da dahildir.
Variants[]. ProductVariantId integer Varyant kimliği.
Variants[]. Code string Varyant kodu.
Variants[]. Barcode string Varyant barkodu.
Variants[]. Price number Varyant fiyatı.
Variants[]. Quantity integer Varyant stoğu.
Variants[]. ImageUrl string Varyant görseli adresi.
Variants[]. VariantValue1 string 1. varyant özelliğinin değeri.
Variants[]. VariantValue2 string 2. varyant özelliğinin değeri.
Variants[]. VariantValue3 string 3. varyant özelliğinin değeri.
Variants[]. VariantValue4 string 4. varyant özelliğinin değeri.
Variants[]. CurrencyId integer Her zaman 0 (okunmaz).
Variants[]. MinSalePrice number Her zaman 0 (okunmaz).
Variants[]. Price2 number Her zaman 0 (Price3, Price4, Price5 de öyle).
Specs object[] Özellikler. Yalnızca ProductId ile sorguda döner.
Specs[]. Name string Özellik adı.
Specs[]. Value string Özellik değeri.
StoreId integer Her zaman 0 (yalnızca istek alanı).
Price2 number Her zaman 0 (Price3, Price4, Price5 de öyle).
UpdateProductByCode boolean Her zaman false (yalnızca istek alanı).
SetProductQuantityFromVariants boolean Her zaman false (yalnızca istek alanı).
UpdateProductDescription boolean Her zaman true (yalnızca istek alanı).

Bu servisin hata kodları

KodNe zaman
70005 Ürün bulunamadı (ErrorMessage: Product was not found!).
70018 Hesabınızda aktif Ürün Paketi yok (ErrorMessage: Ürün entegrasyonu için aktif Ürün Paketi gereklidir.).
99999 Beklenmeyen bir hata oluştu.

Oturum hataları (00001, 00006) ve tüm kodlar için hata kodları.

İlgili servisler

Örnek istek

{
  "ApiCode": "API_CODE",
  "ProductId": 987654
}

Örnek yanıt

{
  "Result": true,
  "Response": {
    "ProductId": 987654,
    "ProductSourceId": 1234,
    "Description": "<p>%100 pamuk, regular fit.</p>",
    "Code": "TSHIRT-001",
    "Code2": "",
    "Barcode": "8690000000017",
    "Name": "Basic Pamuklu Tişört",
    "Subtitle": "",
    "Price": 249.9,
    "Quantity": 30,
    "Brand": "Örnek Marka",
    "TaxRate": 20.0,
    "Model": "BSC-01",
    "Category": "Tişört",
    "CurrencyId": 4,
    "Images": [
      {
        "Order": 0,
        "Url": "https://cdn.example.com/tshirt-001-1.jpg"
      },
      {
        "Order": 1,
        "Url": "https://cdn.example.com/tshirt-001-2.jpg"
      }
    ],
    "MarketPrice": 299.9,
    "Status": 1,
    "Volume": 1.0,
    "Height": 0.0,
    "Length": 0.0,
    "Width": 0.0,
    "VariantName1": "Renk",
    "VariantName2": "Beden",
    "Variants": [
      {
        "ProductVariantId": 5550001,
        "Code": "TSHIRT-001-BLK-M",
        "Price": 249.9,
        "Price2": 0.0,
        "Price3": 0.0,
        "Price4": 0.0,
        "Price5": 0.0,
        "Quantity": 10,
        "Barcode": "8690000000024",
        "CurrencyId": 0,
        "ImageUrl": "",
        "VariantValue1": "Siyah",
        "VariantValue2": "M",
        "VariantValue3": "",
        "VariantValue4": "",
        "MinSalePrice": 0.0
      }
    ],
    "Specs": [
      {
        "Name": "Materyal",
        "Value": "Pamuk"
      }
    ],
    "Url": "",
    "StoreId": 0,
    "Weight": 0.0,
    "CreationTime": "2025-11-05T10:22:31.497",
    "UpdateProductByCode": false,
    "SetProductQuantityFromVariants": false,
    "DispatchPeriod": 2,
    "Price2": 0.0,
    "Price3": 0.0,
    "Price4": 0.0,
    "Price5": 0.0,
    "UpdateProductDescription": true,
    "SoldCount": 0,
    "SellerNote": ""
  }
}

Deneyin

İstek tarayıcınızdan doğrudan out.stockmount.com adresine gider. ApiCode bu sitede saklanmaz; yalnızca bu sekme açıkken tutulur.

İstek göndermek için önce ApiCode alın.

↑ ↓ ile gezinin, Enter ile açın, Esc ile kapatın.

Out API'ye bağlan

DoLogin çağrılır ve dönen ApiCode bu sekmede tutulur. API şifreniz bu siteye gönderilmez.