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.
https://out.stockmount.com/api/Product/GetProduct
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.
|
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ı
| Kod | Ne 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
}
curl -X POST 'https://out.stockmount.com/api/Product/GetProduct' \
-H 'Content-Type: application/json' \
-d '{
"ApiCode": "API_CODE",
"ProductId": 987654
}'
using System.Net.Http;
using System.Text;
using var http = new HttpClient();
var json = """
{
"ApiCode": "API_CODE",
"ProductId": 987654
}
""";
var response = await http.PostAsync(
"https://out.stockmount.com/api/Product/GetProduct",
new StringContent(json, Encoding.UTF8, "application/json"));
var result = await response.Content.ReadAsStringAsync();
// Result == false ise ErrorCode ve ErrorMessage alanlarına bakın.
Console.WriteLine(result);
<?php
$body = <<<'JSON'
{
"ApiCode": "API_CODE",
"ProductId": 987654
}
JSON;
$ch = curl_init('https://out.stockmount.com/api/Product/GetProduct');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => $body,
CURLOPT_RETURNTRANSFER => true,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if (!$result['Result']) {
echo $result['ErrorCode'] . ' ' . $result['ErrorMessage'];
}
import requests
payload = {
"ApiCode": "API_CODE",
"ProductId": 987654
}
response = requests.post("https://out.stockmount.com/api/Product/GetProduct", json=payload, timeout=60)
result = response.json()
if not result["Result"]:
print(result["ErrorCode"], result["ErrorMessage"])
const payload = {
"ApiCode": "API_CODE",
"ProductId": 987654
};
const response = await fetch("https://out.stockmount.com/api/Product/GetProduct", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(payload),
});
const result = await response.json();
if (!result.Result) {
console.error(result.ErrorCode, result.ErrorMessage);
}
Ö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.
Son istekler
Bu sekmeden gönderdiğiniz son istekler; birine tıklayınca gövdesi yeniden yüklenir.