İçeriğe geç
Admin API

Product

Serverhttps://magaza-adiniz.myideasoft.com

Product LIST

GET
https://magaza-adiniz.myideasoft.com
/admin-api/products
Bearer
or
OAuth 2.0

Product LIST › query Parameters

sort
​string

Sıralama değeri. Artan sıra için sort=id, azalan sıra için sort=-id

limit
​integer · min: 1 · max: 100

Bir sayfada dönecek Products adedi

Default: 20
page
​integer · min: 1

Hangi sayfadan başlanacağı

Default: 1
id
​integer · min: 1

Tekli ürün listeleme için Product Id

ids
​string

Çoklu ürün listeleme için virgülle ayrılmış Product Id değerleri ids=1,2,3,4

sinceId
​integer · min: 1

Belirtilen id değerinden sonraki kayıtları getirir

parent
​string

Parent Id

brand
​integer · min: -1

Brand Id

category
​integer · min: -1

Product category filtresi

categoryIds
​string

Çoklu category Id için virgülle ayrılmış değerler

midblock
​integer · min: 1

Product midblock filtresi

selfDistributor
​integer · min: 1

Product self distributor filtresi

distributor
​string

Search key filter.

specialty
​string

Product specialty filtresi

hasOption
​string

Product hasOption filtresi

status
​string · enum

Product status filtresi

Enum values:
0
1
specValue
​integer · min: 1

Product spec value filtresi

specName
​integer · min: 1

Product spec name filtresi

specGroup
​integer · min: 1

Product spec group filtresi

startCreatedAt
​string · date · pattern: yyyy-mm-dd

createdAt başlangıç tarihi

endCreatedAt
​string · date · pattern: yyyy-mm-dd

createdAt bitiş tarihi

startUpdatedAt
​string · date-time · pattern: yyyy-mm-dd hh:mm:ss

updatedAt başlangıç tarihi

endUpdatedAt
​string · date · pattern: yyyy-mm-dd

updatedAt bitiş tarihi

startCountDownDate
​string · date · pattern: yyyy-mm-dd

Zaman aralığı başlangıcı

endCountDownDate
​string · date · pattern: yyyy-mm-dd

Zaman aralığı bitişi

filterCurrency
​integer · min: 1

Currency filtresi

buttonType
​string · enum

Product button type filtresi

Enum values:
fastShipping
sameDayShipping
threeDaysDelivery
fiveDaysDelivery
sevenDaysDelivery
freeShipping
deliveryFromStock
preOrderedProduct
minPrice
​string

Product minimum fiyat filtresi

maxPrice
​string

Product maksimum fiyat filtresi

criticalStock
​string · enum

Product critical stock filtresi

Enum values:
0
1
stockAmount
​integer · min: 0

Product stock amount filtresi

stockExpr
​string · enum

Product stock expr filtresi

Enum values:
eq
gte
lte
digitalProduct
​string · enum

Dijital product filter.

Enum values:
0
1
currency
​string

Product currency abbr filter.

currencyExpr
​string · enum

Product currency abbr condition filter.

Enum values:
eq
neq
q
​string

Product arama filtresi. Kullanımı: q[<geçerli-query-parametresi>]

s
​string

Arama anahtarı ile filtreleme

collection
​integer · min: 1

Product collection search filter.

Product LIST › Responses

İşlem (GET veya PUT) başarı ile sonuçlandı.

Ürün detay objesi
id
​integer · required

Ürün için benzersiz kimlik

Example: 123
name
​string · maxLength: 255

Ürün adı

Example: Kalem
fullName
​string · maxLength: 255

Tam ürün adı (varyantlar için ana ürün + varyant adı)

Example: Kalem Kırmızı
slug
​string · minLength: 1 · maxLength: 255 · pattern: ^[a-z0-9-]+$

URL dostu benzersiz tanımlayıcı

Example: kalem
sku
​string · maxLength: 255

Stok kodu (benzersiz)

Example: KAL-1234
barcode
​string · maxLength: 255 · pattern: ^[0-9]{8,14}$

Ürün barkodu

Example: 869456789874
stockAmount
​number · decimal · min: 0

Mevcut stok miktarı

Example: 100
price1
​number · decimal · min: 0

Ana satış fiyatı (Fiyat 1)

Example: 10.99
​CurrencySummary
discount
​number · decimal · min: 0

İndirim değeri (tip'e göre ₺ veya %)

Example: 5
discountType
​integer · enum

İndirim tipi

Enum values:
0
1
Example: 1
moneyOrderDiscount
​number · decimal · min: 0 · max: 99

Havale/EFT indirim yüzdesi

Example: 10
buyingPrice
​number · decimal · min: 0

Alış fiyatı

Example: 5.5
marketPriceDetail
​string · maxLength: 255

Piyasa fiyatı açıklaması

Example: Diğer mağazalarda 15 TL
taxIncluded
​integer · enum

Fiyatlara KDV dahil mi?

Enum values:
0
1
Example: 1
tax
​integer · decimal · min: 0

KDV oranı (%)

Example: 20
warranty
​integer · min: 0

Garanti süresi (ay)

Example: 24
volumetricWeight
​number · decimal · min: 0

Desi (hacimsel ağırlık)

Example: 1.5
stockTypeLabel
​string · enum

Stok birim tipi

Enum values:
Piece
cm
Dozen
gram
kg
Person
Package
metre
Example: Piece
customShippingDisabled
​integer · enum

Özel kargo ücreti kullanılsın mı?

Enum values:
0
1
Example: 0
customShippingCost
​number · decimal · min: 0

Özel kargo ücreti (customShippingDisabled=0 ise)

Example: 5
distributor
​string · maxLength: 255

Tedarikçi adı

Example: superTedarik
hasGift
​integer · enum

Ürün hediyeli mi?

Enum values:
0
1
Example: 0
gift
​string · maxLength: 255

Hediye açıklaması

Example: Silgi hediyeli
status
​integer · enum

Ürün aktiflik durumu

Enum values:
0
1
Example: 1
hasOption
​integer · enum · readOnly

Varyant var mı? (sistem otomatik atar)

Enum values:
0
1
Example: 0
shortDetails
​string · maxLength: 512

Kısa ürün açıklaması

Example: Yumuşak uçlu, kırmızı renkli kalem.
searchKeywords
​string · maxLength: 255

Arama anahtar kelimeleri (virgülle ayrılmış)

Example: kırmızı, kalem, kırtasiye
installmentThreshold
​string · maxLength: 10

Maksimum taksit sayısı ('-' = limit yok)

Example: 12
homeSortOrder
​integer | null · max: 500

Anasayfa vitrini sırası (null = vitrin dışı)

Example: 1
popularSortOrder
​integer | null · max: 500

Popüler ürünler vitrini sırası

Example: 1
brandSortOrder
​integer | null · max: 500

Marka vitrini sırası

Example: 1
featuredSortOrder
​integer | null · max: 500

Sponsor ürünler vitrini sırası

Example: 1
campaignedSortOrder
​integer | null · max: 500

Kampanyalı ürünler vitrini sırası

Example: 1
newSortOrder
​integer | null · max: 500

Yeni ürünler vitrini sırası

Example: 1
discountedSortOrder
​integer | null · max: 500

İndirimli ürünler vitrini sırası

Example: 1
categoryShowcaseStatus
​integer · enum

Kategori vitrininde gösterim durumu

Enum values:
0
1
Example: 1
collectionShowcaseStatus
​integer · enum
Enum values:
0
1
midblockSortOrder
​integer | null · max: 9999

Vitrin blokları sırası

Example: 1
pageTitle
​string · maxLength: 255

SEO sayfa başlığı

Example: Kırmızı Kalem
metaDescription
​string

SEO meta açıklama

Example: Kaliteli kırtasiye ürünleri.
metaKeywords
​string

SEO meta anahtar kelimeler

Example: kırmızı, kalem, kırtasiye
canonicalUrl
​string · pattern: ^[a-z0-9-/]+$

Canonical URL (domain hariç)

Example: urun/kalem
​

Ana ürün objesi (varyantlar için)

​BrandSummary

Marka objesi

Ürün buton ve rozet gösterim ayarları objesi

Ürünlere eklenebilen özel bilgi alanlarını temsil eder. Bu alanlar ürün detay sayfasında açıklama, teknik bilgi veya özel metin göstermek için kullanılır.

​SpecGroupSummary

Ürün özellik grubu objesi

​CategorySummary[]

İlişkili kategoriler listesi

Alternatif fiyatlar listesi

​DistributorSummary[]

Tedarikçiler listesi

Ek bilgiler listesi

Ürün görselleri listesi

Etiketler listesi

​SelectionGroupSummary[]

Ek özellik grupları

​OptionGroupSummary[]

Varyant grupları

Ürün etiketleri

​OfferedProductSummary[]

Tavsiye edilen ürünler

​CombineProductSummary[]

Kombine ürünler

Özelleştirme grupları

​MidblockSummary

Vitrin bloğu objesi

​SeoSettingSummary
​ProductSummary[]

Varyant ürünler (ana ürün için)

updatedAt
​string · date-time

Kayıt son güncellenme tarihi

Example: 2018-02-21T15:01:03+0300
createdAt
​string · date-time

Kayıt oluşturulma tarihi

Example: 2018-02-21T09:36:03+0300
​ProductExtraFieldSummary[]
​DigitalProductSummary
targetKeyword
​string · maxLength: 255
solvedCount
​integer
seoTotalRuleCount
​integer
next
​string · writeOnly
prev
​string · writeOnly

Product POST

POST
https://magaza-adiniz.myideasoft.com
/admin-api/products
Bearer
or
OAuth 2.0

Product POST › Request Body

Ürün detay objesi
id
​integer · required

Ürün için benzersiz kimlik

Example: 123
name
​string · maxLength: 255

Ürün adı

Example: Kalem
fullName
​string · maxLength: 255

Tam ürün adı (varyantlar için ana ürün + varyant adı)

Example: Kalem Kırmızı
slug
​string · minLength: 1 · maxLength: 255 · pattern: ^[a-z0-9-]+$

URL dostu benzersiz tanımlayıcı

Example: kalem
sku
​string · maxLength: 255

Stok kodu (benzersiz)

Example: KAL-1234
barcode
​string · maxLength: 255 · pattern: ^[0-9]{8,14}$

Ürün barkodu

Example: 869456789874
stockAmount
​number · decimal · min: 0

Mevcut stok miktarı

Example: 100
price1
​number · decimal · min: 0

Ana satış fiyatı (Fiyat 1)

Example: 10.99
​CurrencySummary
discount
​number · decimal · min: 0

İndirim değeri (tip'e göre ₺ veya %)

Example: 5
discountType
​integer · enum

İndirim tipi

Enum values:
0
1
Example: 1
moneyOrderDiscount
​number · decimal · min: 0 · max: 99

Havale/EFT indirim yüzdesi

Example: 10
buyingPrice
​number · decimal · min: 0

Alış fiyatı

Example: 5.5
marketPriceDetail
​string · maxLength: 255

Piyasa fiyatı açıklaması

Example: Diğer mağazalarda 15 TL
taxIncluded
​integer · enum

Fiyatlara KDV dahil mi?

Enum values:
0
1
Example: 1
tax
​integer · decimal · min: 0

KDV oranı (%)

Example: 20
warranty
​integer · min: 0

Garanti süresi (ay)

Example: 24
volumetricWeight
​number · decimal · min: 0

Desi (hacimsel ağırlık)

Example: 1.5
stockTypeLabel
​string · enum

Stok birim tipi

Enum values:
Piece
cm
Dozen
gram
kg
Person
Package
metre
Example: Piece
customShippingDisabled
​integer · enum

Özel kargo ücreti kullanılsın mı?

Enum values:
0
1
Example: 0
customShippingCost
​number · decimal · min: 0

Özel kargo ücreti (customShippingDisabled=0 ise)

Example: 5
distributor
​string · maxLength: 255

Tedarikçi adı

Example: superTedarik
hasGift
​integer · enum

Ürün hediyeli mi?

Enum values:
0
1
Example: 0
gift
​string · maxLength: 255

Hediye açıklaması

Example: Silgi hediyeli
status
​integer · enum

Ürün aktiflik durumu

Enum values:
0
1
Example: 1
hasOption
​integer · enum · readOnly

Varyant var mı? (sistem otomatik atar)

Enum values:
0
1
Example: 0
shortDetails
​string · maxLength: 512

Kısa ürün açıklaması

Example: Yumuşak uçlu, kırmızı renkli kalem.
searchKeywords
​string · maxLength: 255

Arama anahtar kelimeleri (virgülle ayrılmış)

Example: kırmızı, kalem, kırtasiye
installmentThreshold
​string · maxLength: 10

Maksimum taksit sayısı ('-' = limit yok)

Example: 12
homeSortOrder
​integer | null · max: 500

Anasayfa vitrini sırası (null = vitrin dışı)

Example: 1
popularSortOrder
​integer | null · max: 500

Popüler ürünler vitrini sırası

Example: 1
brandSortOrder
​integer | null · max: 500

Marka vitrini sırası

Example: 1
featuredSortOrder
​integer | null · max: 500

Sponsor ürünler vitrini sırası

Example: 1
campaignedSortOrder
​integer | null · max: 500

Kampanyalı ürünler vitrini sırası

Example: 1
newSortOrder
​integer | null · max: 500

Yeni ürünler vitrini sırası

Example: 1
discountedSortOrder
​integer | null · max: 500

İndirimli ürünler vitrini sırası

Example: 1
categoryShowcaseStatus
​integer · enum

Kategori vitrininde gösterim durumu

Enum values:
0
1
Example: 1
collectionShowcaseStatus
​integer · enum
Enum values:
0
1
midblockSortOrder
​integer | null · max: 9999

Vitrin blokları sırası

Example: 1
pageTitle
​string · maxLength: 255

SEO sayfa başlığı

Example: Kırmızı Kalem
metaDescription
​string

SEO meta açıklama

Example: Kaliteli kırtasiye ürünleri.
metaKeywords
​string

SEO meta anahtar kelimeler

Example: kırmızı, kalem, kırtasiye
canonicalUrl
​string · pattern: ^[a-z0-9-/]+$

Canonical URL (domain hariç)

Example: urun/kalem
​

Ana ürün objesi (varyantlar için)

​BrandSummary

Marka objesi

Ürün buton ve rozet gösterim ayarları objesi

Ürünlere eklenebilen özel bilgi alanlarını temsil eder. Bu alanlar ürün detay sayfasında açıklama, teknik bilgi veya özel metin göstermek için kullanılır.

​SpecGroupSummary

Ürün özellik grubu objesi

​CategorySummary[]

İlişkili kategoriler listesi

Alternatif fiyatlar listesi

​DistributorSummary[]

Tedarikçiler listesi

Ek bilgiler listesi

Ürün görselleri listesi

Etiketler listesi

​SelectionGroupSummary[]

Ek özellik grupları

​OptionGroupSummary[]

Varyant grupları

Ürün etiketleri

​OfferedProductSummary[]

Tavsiye edilen ürünler

​CombineProductSummary[]

Kombine ürünler

Özelleştirme grupları

​MidblockSummary

Vitrin bloğu objesi

​SeoSettingSummary
​ProductSummary[]

Varyant ürünler (ana ürün için)

updatedAt
​string · date-time

Kayıt son güncellenme tarihi

Example: 2018-02-21T15:01:03+0300
createdAt
​string · date-time

Kayıt oluşturulma tarihi

Example: 2018-02-21T09:36:03+0300
​ProductExtraFieldSummary[]
​DigitalProductSummary
targetKeyword
​string · maxLength: 255
solvedCount
​integer
seoTotalRuleCount
​integer
next
​string · writeOnly
prev
​string · writeOnly

Product POST › Responses

Oluşturma işlemi (POST) başarı ile sonuçlandı.

Ürün detay objesi
id
​integer · required

Ürün için benzersiz kimlik

Example: 123
name
​string · maxLength: 255

Ürün adı

Example: Kalem
fullName
​string · maxLength: 255

Tam ürün adı (varyantlar için ana ürün + varyant adı)

Example: Kalem Kırmızı
slug
​string · minLength: 1 · maxLength: 255 · pattern: ^[a-z0-9-]+$

URL dostu benzersiz tanımlayıcı

Example: kalem
sku
​string · maxLength: 255

Stok kodu (benzersiz)

Example: KAL-1234
barcode
​string · maxLength: 255 · pattern: ^[0-9]{8,14}$

Ürün barkodu

Example: 869456789874
stockAmount
​number · decimal · min: 0

Mevcut stok miktarı

Example: 100
price1
​number · decimal · min: 0

Ana satış fiyatı (Fiyat 1)

Example: 10.99
​CurrencySummary
discount
​number · decimal · min: 0

İndirim değeri (tip'e göre ₺ veya %)

Example: 5
discountType
​integer · enum

İndirim tipi

Enum values:
0
1
Example: 1
moneyOrderDiscount
​number · decimal · min: 0 · max: 99

Havale/EFT indirim yüzdesi

Example: 10
buyingPrice
​number · decimal · min: 0

Alış fiyatı

Example: 5.5
marketPriceDetail
​string · maxLength: 255

Piyasa fiyatı açıklaması

Example: Diğer mağazalarda 15 TL
taxIncluded
​integer · enum

Fiyatlara KDV dahil mi?

Enum values:
0
1
Example: 1
tax
​integer · decimal · min: 0

KDV oranı (%)

Example: 20
warranty
​integer · min: 0

Garanti süresi (ay)

Example: 24
volumetricWeight
​number · decimal · min: 0

Desi (hacimsel ağırlık)

Example: 1.5
stockTypeLabel
​string · enum

Stok birim tipi

Enum values:
Piece
cm
Dozen
gram
kg
Person
Package
metre
Example: Piece
customShippingDisabled
​integer · enum

Özel kargo ücreti kullanılsın mı?

Enum values:
0
1
Example: 0
customShippingCost
​number · decimal · min: 0

Özel kargo ücreti (customShippingDisabled=0 ise)

Example: 5
distributor
​string · maxLength: 255

Tedarikçi adı

Example: superTedarik
hasGift
​integer · enum

Ürün hediyeli mi?

Enum values:
0
1
Example: 0
gift
​string · maxLength: 255

Hediye açıklaması

Example: Silgi hediyeli
status
​integer · enum

Ürün aktiflik durumu

Enum values:
0
1
Example: 1
hasOption
​integer · enum · readOnly

Varyant var mı? (sistem otomatik atar)

Enum values:
0
1
Example: 0
shortDetails
​string · maxLength: 512

Kısa ürün açıklaması

Example: Yumuşak uçlu, kırmızı renkli kalem.
searchKeywords
​string · maxLength: 255

Arama anahtar kelimeleri (virgülle ayrılmış)

Example: kırmızı, kalem, kırtasiye
installmentThreshold
​string · maxLength: 10

Maksimum taksit sayısı ('-' = limit yok)

Example: 12
homeSortOrder
​integer | null · max: 500

Anasayfa vitrini sırası (null = vitrin dışı)

Example: 1
popularSortOrder
​integer | null · max: 500

Popüler ürünler vitrini sırası

Example: 1
brandSortOrder
​integer | null · max: 500

Marka vitrini sırası

Example: 1
featuredSortOrder
​integer | null · max: 500

Sponsor ürünler vitrini sırası

Example: 1
campaignedSortOrder
​integer | null · max: 500

Kampanyalı ürünler vitrini sırası

Example: 1
newSortOrder
​integer | null · max: 500

Yeni ürünler vitrini sırası

Example: 1
discountedSortOrder
​integer | null · max: 500

İndirimli ürünler vitrini sırası

Example: 1
categoryShowcaseStatus
​integer · enum

Kategori vitrininde gösterim durumu

Enum values:
0
1
Example: 1
collectionShowcaseStatus
​integer · enum
Enum values:
0
1
midblockSortOrder
​integer | null · max: 9999

Vitrin blokları sırası

Example: 1
pageTitle
​string · maxLength: 255

SEO sayfa başlığı

Example: Kırmızı Kalem
metaDescription
​string

SEO meta açıklama

Example: Kaliteli kırtasiye ürünleri.
metaKeywords
​string

SEO meta anahtar kelimeler

Example: kırmızı, kalem, kırtasiye
canonicalUrl
​string · pattern: ^[a-z0-9-/]+$

Canonical URL (domain hariç)

Example: urun/kalem
​

Ana ürün objesi (varyantlar için)

​BrandSummary

Marka objesi

Ürün buton ve rozet gösterim ayarları objesi

Ürünlere eklenebilen özel bilgi alanlarını temsil eder. Bu alanlar ürün detay sayfasında açıklama, teknik bilgi veya özel metin göstermek için kullanılır.

​SpecGroupSummary

Ürün özellik grubu objesi

​CategorySummary[]

İlişkili kategoriler listesi

Alternatif fiyatlar listesi

​DistributorSummary[]

Tedarikçiler listesi

Ek bilgiler listesi

Ürün görselleri listesi

Etiketler listesi

​SelectionGroupSummary[]

Ek özellik grupları

​OptionGroupSummary[]

Varyant grupları

Ürün etiketleri

​OfferedProductSummary[]

Tavsiye edilen ürünler

​CombineProductSummary[]

Kombine ürünler

Özelleştirme grupları

​MidblockSummary

Vitrin bloğu objesi

​SeoSettingSummary
​ProductSummary[]

Varyant ürünler (ana ürün için)

updatedAt
​string · date-time

Kayıt son güncellenme tarihi

Example: 2018-02-21T15:01:03+0300
createdAt
​string · date-time

Kayıt oluşturulma tarihi

Example: 2018-02-21T09:36:03+0300
​ProductExtraFieldSummary[]
​DigitalProductSummary
targetKeyword
​string · maxLength: 255
solvedCount
​integer
seoTotalRuleCount
​integer
next
​string · writeOnly
prev
​string · writeOnly

Product COUNT

GET
https://magaza-adiniz.myideasoft.com
/admin-api/products/count
Bearer
or
OAuth 2.0

Product COUNT › query Parameters

sort
​string

Sıralama değeri. Artan sıra için sort=id, azalan sıra için sort=-id

limit
​integer · min: 1 · max: 100

Bir sayfada dönecek Products adedi

Default: 20
page
​integer · min: 1

Hangi sayfadan başlanacağı

Default: 1
id
​integer · min: 1

Tekli ürün listeleme için Product Id

ids
​string

Çoklu ürün listeleme için virgülle ayrılmış Product Id değerleri ids=1,2,3,4

sinceId
​integer · min: 1

Belirtilen id değerinden sonraki kayıtları getirir

parent
​string

Parent Id

brand
​integer · min: -1

Brand Id

category
​integer · min: -1

Product category filtresi

categoryIds
​string

Çoklu category Id için virgülle ayrılmış değerler

midblock
​integer · min: 1

Product midblock filtresi

selfDistributor
​integer · min: 1

Product self distributor filtresi

distributor
​string

Search key filter.

specialty
​string

Product specialty filtresi

hasOption
​string

Product hasOption filtresi

status
​string · enum

Product status filtresi

Enum values:
0
1
specValue
​integer · min: 1

Product spec value filtresi

specName
​integer · min: 1

Product spec name filtresi

specGroup
​integer · min: 1

Product spec group filtresi

startCreatedAt
​string · date · pattern: yyyy-mm-dd

createdAt başlangıç tarihi

endCreatedAt
​string · date · pattern: yyyy-mm-dd

createdAt bitiş tarihi

startUpdatedAt
​string · date-time · pattern: yyyy-mm-dd hh:mm:ss

updatedAt başlangıç tarihi

endUpdatedAt
​string · date · pattern: yyyy-mm-dd

updatedAt bitiş tarihi

startCountDownDate
​string · date · pattern: yyyy-mm-dd

Zaman aralığı başlangıcı

endCountDownDate
​string · date · pattern: yyyy-mm-dd

Zaman aralığı bitişi

filterCurrency
​integer · min: 1

Currency filtresi

buttonType
​string · enum

Product button type filtresi

Enum values:
fastShipping
sameDayShipping
threeDaysDelivery
fiveDaysDelivery
sevenDaysDelivery
freeShipping
deliveryFromStock
preOrderedProduct
minPrice
​string

Product minimum fiyat filtresi

maxPrice
​string

Product maksimum fiyat filtresi

criticalStock
​string · enum

Product critical stock filtresi

Enum values:
0
1
stockAmount
​integer · min: 0

Product stock amount filtresi

stockExpr
​string · enum

Product stock expr filtresi

Enum values:
eq
gte
lte
digitalProduct
​string · enum

Dijital product filter.

Enum values:
0
1
currency
​string

Product currency abbr filter.

currencyExpr
​string · enum

Product currency abbr condition filter.

Enum values:
eq
neq
q
​string

Product arama filtresi. Kullanımı: q[<geçerli-query-parametresi>]

s
​string

Arama anahtarı ile filtreleme

collection
​integer · min: 1

Product collection search filter.

Product COUNT › Responses

İşlem (GET veya PUT) başarı ile sonuçlandı.

Kayıt sayısı yanıtı.
total_count
​integer · required

Filtrelere uyan toplam kayıt sayısı.


Product GET

GET
https://magaza-adiniz.myideasoft.com
/admin-api/products/{id}
Bearer
or
OAuth 2.0

Product GET › path Parameters

id
​string · pattern: \d+ · required

Product GET › Responses

İşlem (GET veya PUT) başarı ile sonuçlandı.

Ürün detay objesi
id
​integer · required

Ürün için benzersiz kimlik

Example: 123
name
​string · maxLength: 255

Ürün adı

Example: Kalem
fullName
​string · maxLength: 255

Tam ürün adı (varyantlar için ana ürün + varyant adı)

Example: Kalem Kırmızı
slug
​string · minLength: 1 · maxLength: 255 · pattern: ^[a-z0-9-]+$

URL dostu benzersiz tanımlayıcı

Example: kalem
sku
​string · maxLength: 255

Stok kodu (benzersiz)

Example: KAL-1234
barcode
​string · maxLength: 255 · pattern: ^[0-9]{8,14}$

Ürün barkodu

Example: 869456789874
stockAmount
​number · decimal · min: 0

Mevcut stok miktarı

Example: 100
price1
​number · decimal · min: 0

Ana satış fiyatı (Fiyat 1)

Example: 10.99
​CurrencySummary
discount
​number · decimal · min: 0

İndirim değeri (tip'e göre ₺ veya %)

Example: 5
discountType
​integer · enum

İndirim tipi

Enum values:
0
1
Example: 1
moneyOrderDiscount
​number · decimal · min: 0 · max: 99

Havale/EFT indirim yüzdesi

Example: 10
buyingPrice
​number · decimal · min: 0

Alış fiyatı

Example: 5.5
marketPriceDetail
​string · maxLength: 255

Piyasa fiyatı açıklaması

Example: Diğer mağazalarda 15 TL
taxIncluded
​integer · enum

Fiyatlara KDV dahil mi?

Enum values:
0
1
Example: 1
tax
​integer · decimal · min: 0

KDV oranı (%)

Example: 20
warranty
​integer · min: 0

Garanti süresi (ay)

Example: 24
volumetricWeight
​number · decimal · min: 0

Desi (hacimsel ağırlık)

Example: 1.5
stockTypeLabel
​string · enum

Stok birim tipi

Enum values:
Piece
cm
Dozen
gram
kg
Person
Package
metre
Example: Piece
customShippingDisabled
​integer · enum

Özel kargo ücreti kullanılsın mı?

Enum values:
0
1
Example: 0
customShippingCost
​number · decimal · min: 0

Özel kargo ücreti (customShippingDisabled=0 ise)

Example: 5
distributor
​string · maxLength: 255

Tedarikçi adı

Example: superTedarik
hasGift
​integer · enum

Ürün hediyeli mi?

Enum values:
0
1
Example: 0
gift
​string · maxLength: 255

Hediye açıklaması

Example: Silgi hediyeli
status
​integer · enum

Ürün aktiflik durumu

Enum values:
0
1
Example: 1
hasOption
​integer · enum · readOnly

Varyant var mı? (sistem otomatik atar)

Enum values:
0
1
Example: 0
shortDetails
​string · maxLength: 512

Kısa ürün açıklaması

Example: Yumuşak uçlu, kırmızı renkli kalem.
searchKeywords
​string · maxLength: 255

Arama anahtar kelimeleri (virgülle ayrılmış)

Example: kırmızı, kalem, kırtasiye
installmentThreshold
​string · maxLength: 10

Maksimum taksit sayısı ('-' = limit yok)

Example: 12
homeSortOrder
​integer | null · max: 500

Anasayfa vitrini sırası (null = vitrin dışı)

Example: 1
popularSortOrder
​integer | null · max: 500

Popüler ürünler vitrini sırası

Example: 1
brandSortOrder
​integer | null · max: 500

Marka vitrini sırası

Example: 1
featuredSortOrder
​integer | null · max: 500

Sponsor ürünler vitrini sırası

Example: 1
campaignedSortOrder
​integer | null · max: 500

Kampanyalı ürünler vitrini sırası

Example: 1
newSortOrder
​integer | null · max: 500

Yeni ürünler vitrini sırası

Example: 1
discountedSortOrder
​integer | null · max: 500

İndirimli ürünler vitrini sırası

Example: 1
categoryShowcaseStatus
​integer · enum

Kategori vitrininde gösterim durumu

Enum values:
0
1
Example: 1
collectionShowcaseStatus
​integer · enum
Enum values:
0
1
midblockSortOrder
​integer | null · max: 9999

Vitrin blokları sırası

Example: 1
pageTitle
​string · maxLength: 255

SEO sayfa başlığı

Example: Kırmızı Kalem
metaDescription
​string

SEO meta açıklama

Example: Kaliteli kırtasiye ürünleri.
metaKeywords
​string

SEO meta anahtar kelimeler

Example: kırmızı, kalem, kırtasiye
canonicalUrl
​string · pattern: ^[a-z0-9-/]+$

Canonical URL (domain hariç)

Example: urun/kalem
​

Ana ürün objesi (varyantlar için)

​BrandSummary

Marka objesi

Ürün buton ve rozet gösterim ayarları objesi

Ürünlere eklenebilen özel bilgi alanlarını temsil eder. Bu alanlar ürün detay sayfasında açıklama, teknik bilgi veya özel metin göstermek için kullanılır.

​SpecGroupSummary

Ürün özellik grubu objesi

​CategorySummary[]

İlişkili kategoriler listesi

Alternatif fiyatlar listesi

​DistributorSummary[]

Tedarikçiler listesi

Ek bilgiler listesi

Ürün görselleri listesi

Etiketler listesi

​SelectionGroupSummary[]

Ek özellik grupları

​OptionGroupSummary[]

Varyant grupları

Ürün etiketleri

​OfferedProductSummary[]

Tavsiye edilen ürünler

​CombineProductSummary[]

Kombine ürünler

Özelleştirme grupları

​MidblockSummary

Vitrin bloğu objesi

​SeoSettingSummary
​ProductSummary[]

Varyant ürünler (ana ürün için)

updatedAt
​string · date-time

Kayıt son güncellenme tarihi

Example: 2018-02-21T15:01:03+0300
createdAt
​string · date-time

Kayıt oluşturulma tarihi

Example: 2018-02-21T09:36:03+0300
​ProductExtraFieldSummary[]
​DigitalProductSummary
targetKeyword
​string · maxLength: 255
solvedCount
​integer
seoTotalRuleCount
​integer
next
​string · writeOnly
prev
​string · writeOnly

Product PUT

PUT
https://magaza-adiniz.myideasoft.com
/admin-api/products/{id}
Bearer
or
OAuth 2.0

Product PUT › path Parameters

id
​string · pattern: \d+ · required

Product PUT › Request Body

Ürün detay objesi
id
​integer · required

Ürün için benzersiz kimlik

Example: 123
name
​string · maxLength: 255

Ürün adı

Example: Kalem
fullName
​string · maxLength: 255

Tam ürün adı (varyantlar için ana ürün + varyant adı)

Example: Kalem Kırmızı
slug
​string · minLength: 1 · maxLength: 255 · pattern: ^[a-z0-9-]+$

URL dostu benzersiz tanımlayıcı

Example: kalem
sku
​string · maxLength: 255

Stok kodu (benzersiz)

Example: KAL-1234
barcode
​string · maxLength: 255 · pattern: ^[0-9]{8,14}$

Ürün barkodu

Example: 869456789874
stockAmount
​number · decimal · min: 0

Mevcut stok miktarı

Example: 100
price1
​number · decimal · min: 0

Ana satış fiyatı (Fiyat 1)

Example: 10.99
​CurrencySummary
discount
​number · decimal · min: 0

İndirim değeri (tip'e göre ₺ veya %)

Example: 5
discountType
​integer · enum

İndirim tipi

Enum values:
0
1
Example: 1
moneyOrderDiscount
​number · decimal · min: 0 · max: 99

Havale/EFT indirim yüzdesi

Example: 10
buyingPrice
​number · decimal · min: 0

Alış fiyatı

Example: 5.5
marketPriceDetail
​string · maxLength: 255

Piyasa fiyatı açıklaması

Example: Diğer mağazalarda 15 TL
taxIncluded
​integer · enum

Fiyatlara KDV dahil mi?

Enum values:
0
1
Example: 1
tax
​integer · decimal · min: 0

KDV oranı (%)

Example: 20
warranty
​integer · min: 0

Garanti süresi (ay)

Example: 24
volumetricWeight
​number · decimal · min: 0

Desi (hacimsel ağırlık)

Example: 1.5
stockTypeLabel
​string · enum

Stok birim tipi

Enum values:
Piece
cm
Dozen
gram
kg
Person
Package
metre
Example: Piece
customShippingDisabled
​integer · enum

Özel kargo ücreti kullanılsın mı?

Enum values:
0
1
Example: 0
customShippingCost
​number · decimal · min: 0

Özel kargo ücreti (customShippingDisabled=0 ise)

Example: 5
distributor
​string · maxLength: 255

Tedarikçi adı

Example: superTedarik
hasGift
​integer · enum

Ürün hediyeli mi?

Enum values:
0
1
Example: 0
gift
​string · maxLength: 255

Hediye açıklaması

Example: Silgi hediyeli
status
​integer · enum

Ürün aktiflik durumu

Enum values:
0
1
Example: 1
hasOption
​integer · enum · readOnly

Varyant var mı? (sistem otomatik atar)

Enum values:
0
1
Example: 0
shortDetails
​string · maxLength: 512

Kısa ürün açıklaması

Example: Yumuşak uçlu, kırmızı renkli kalem.
searchKeywords
​string · maxLength: 255

Arama anahtar kelimeleri (virgülle ayrılmış)

Example: kırmızı, kalem, kırtasiye
installmentThreshold
​string · maxLength: 10

Maksimum taksit sayısı ('-' = limit yok)

Example: 12
homeSortOrder
​integer | null · max: 500

Anasayfa vitrini sırası (null = vitrin dışı)

Example: 1
popularSortOrder
​integer | null · max: 500

Popüler ürünler vitrini sırası

Example: 1
brandSortOrder
​integer | null · max: 500

Marka vitrini sırası

Example: 1
featuredSortOrder
​integer | null · max: 500

Sponsor ürünler vitrini sırası

Example: 1
campaignedSortOrder
​integer | null · max: 500

Kampanyalı ürünler vitrini sırası

Example: 1
newSortOrder
​integer | null · max: 500

Yeni ürünler vitrini sırası

Example: 1
discountedSortOrder
​integer | null · max: 500

İndirimli ürünler vitrini sırası

Example: 1
categoryShowcaseStatus
​integer · enum

Kategori vitrininde gösterim durumu

Enum values:
0
1
Example: 1
collectionShowcaseStatus
​integer · enum
Enum values:
0
1
midblockSortOrder
​integer | null · max: 9999

Vitrin blokları sırası

Example: 1
pageTitle
​string · maxLength: 255

SEO sayfa başlığı

Example: Kırmızı Kalem
metaDescription
​string

SEO meta açıklama

Example: Kaliteli kırtasiye ürünleri.
metaKeywords
​string

SEO meta anahtar kelimeler

Example: kırmızı, kalem, kırtasiye
canonicalUrl
​string · pattern: ^[a-z0-9-/]+$

Canonical URL (domain hariç)

Example: urun/kalem
​

Ana ürün objesi (varyantlar için)

​BrandSummary

Marka objesi

Ürün buton ve rozet gösterim ayarları objesi

Ürünlere eklenebilen özel bilgi alanlarını temsil eder. Bu alanlar ürün detay sayfasında açıklama, teknik bilgi veya özel metin göstermek için kullanılır.

​SpecGroupSummary

Ürün özellik grubu objesi

​CategorySummary[]

İlişkili kategoriler listesi

Alternatif fiyatlar listesi

​DistributorSummary[]

Tedarikçiler listesi

Ek bilgiler listesi

Ürün görselleri listesi

Etiketler listesi

​SelectionGroupSummary[]

Ek özellik grupları

​OptionGroupSummary[]

Varyant grupları

Ürün etiketleri

​OfferedProductSummary[]

Tavsiye edilen ürünler

​CombineProductSummary[]

Kombine ürünler

Özelleştirme grupları

​MidblockSummary

Vitrin bloğu objesi

​SeoSettingSummary
​ProductSummary[]

Varyant ürünler (ana ürün için)

updatedAt
​string · date-time

Kayıt son güncellenme tarihi

Example: 2018-02-21T15:01:03+0300
createdAt
​string · date-time

Kayıt oluşturulma tarihi

Example: 2018-02-21T09:36:03+0300
​ProductExtraFieldSummary[]
​DigitalProductSummary
targetKeyword
​string · maxLength: 255
solvedCount
​integer
seoTotalRuleCount
​integer
next
​string · writeOnly
prev
​string · writeOnly

Product PUT › Responses

İşlem (GET veya PUT) başarı ile sonuçlandı.

Ürün detay objesi
id
​integer · required

Ürün için benzersiz kimlik

Example: 123
name
​string · maxLength: 255

Ürün adı

Example: Kalem
fullName
​string · maxLength: 255

Tam ürün adı (varyantlar için ana ürün + varyant adı)

Example: Kalem Kırmızı
slug
​string · minLength: 1 · maxLength: 255 · pattern: ^[a-z0-9-]+$

URL dostu benzersiz tanımlayıcı

Example: kalem
sku
​string · maxLength: 255

Stok kodu (benzersiz)

Example: KAL-1234
barcode
​string · maxLength: 255 · pattern: ^[0-9]{8,14}$

Ürün barkodu

Example: 869456789874
stockAmount
​number · decimal · min: 0

Mevcut stok miktarı

Example: 100
price1
​number · decimal · min: 0

Ana satış fiyatı (Fiyat 1)

Example: 10.99
​CurrencySummary
discount
​number · decimal · min: 0

İndirim değeri (tip'e göre ₺ veya %)

Example: 5
discountType
​integer · enum

İndirim tipi

Enum values:
0
1
Example: 1
moneyOrderDiscount
​number · decimal · min: 0 · max: 99

Havale/EFT indirim yüzdesi

Example: 10
buyingPrice
​number · decimal · min: 0

Alış fiyatı

Example: 5.5
marketPriceDetail
​string · maxLength: 255

Piyasa fiyatı açıklaması

Example: Diğer mağazalarda 15 TL
taxIncluded
​integer · enum

Fiyatlara KDV dahil mi?

Enum values:
0
1
Example: 1
tax
​integer · decimal · min: 0

KDV oranı (%)

Example: 20
warranty
​integer · min: 0

Garanti süresi (ay)

Example: 24
volumetricWeight
​number · decimal · min: 0

Desi (hacimsel ağırlık)

Example: 1.5
stockTypeLabel
​string · enum

Stok birim tipi

Enum values:
Piece
cm
Dozen
gram
kg
Person
Package
metre
Example: Piece
customShippingDisabled
​integer · enum

Özel kargo ücreti kullanılsın mı?

Enum values:
0
1
Example: 0
customShippingCost
​number · decimal · min: 0

Özel kargo ücreti (customShippingDisabled=0 ise)

Example: 5
distributor
​string · maxLength: 255

Tedarikçi adı

Example: superTedarik
hasGift
​integer · enum

Ürün hediyeli mi?

Enum values:
0
1
Example: 0
gift
​string · maxLength: 255

Hediye açıklaması

Example: Silgi hediyeli
status
​integer · enum

Ürün aktiflik durumu

Enum values:
0
1
Example: 1
hasOption
​integer · enum · readOnly

Varyant var mı? (sistem otomatik atar)

Enum values:
0
1
Example: 0
shortDetails
​string · maxLength: 512

Kısa ürün açıklaması

Example: Yumuşak uçlu, kırmızı renkli kalem.
searchKeywords
​string · maxLength: 255

Arama anahtar kelimeleri (virgülle ayrılmış)

Example: kırmızı, kalem, kırtasiye
installmentThreshold
​string · maxLength: 10

Maksimum taksit sayısı ('-' = limit yok)

Example: 12
homeSortOrder
​integer | null · max: 500

Anasayfa vitrini sırası (null = vitrin dışı)

Example: 1
popularSortOrder
​integer | null · max: 500

Popüler ürünler vitrini sırası

Example: 1
brandSortOrder
​integer | null · max: 500

Marka vitrini sırası

Example: 1
featuredSortOrder
​integer | null · max: 500

Sponsor ürünler vitrini sırası

Example: 1
campaignedSortOrder
​integer | null · max: 500

Kampanyalı ürünler vitrini sırası

Example: 1
newSortOrder
​integer | null · max: 500

Yeni ürünler vitrini sırası

Example: 1
discountedSortOrder
​integer | null · max: 500

İndirimli ürünler vitrini sırası

Example: 1
categoryShowcaseStatus
​integer · enum

Kategori vitrininde gösterim durumu

Enum values:
0
1
Example: 1
collectionShowcaseStatus
​integer · enum
Enum values:
0
1
midblockSortOrder
​integer | null · max: 9999

Vitrin blokları sırası

Example: 1
pageTitle
​string · maxLength: 255

SEO sayfa başlığı

Example: Kırmızı Kalem
metaDescription
​string

SEO meta açıklama

Example: Kaliteli kırtasiye ürünleri.
metaKeywords
​string

SEO meta anahtar kelimeler

Example: kırmızı, kalem, kırtasiye
canonicalUrl
​string · pattern: ^[a-z0-9-/]+$

Canonical URL (domain hariç)

Example: urun/kalem
​

Ana ürün objesi (varyantlar için)

​BrandSummary

Marka objesi

Ürün buton ve rozet gösterim ayarları objesi

Ürünlere eklenebilen özel bilgi alanlarını temsil eder. Bu alanlar ürün detay sayfasında açıklama, teknik bilgi veya özel metin göstermek için kullanılır.

​SpecGroupSummary

Ürün özellik grubu objesi

​CategorySummary[]

İlişkili kategoriler listesi

Alternatif fiyatlar listesi

​DistributorSummary[]

Tedarikçiler listesi

Ek bilgiler listesi

Ürün görselleri listesi

Etiketler listesi

​SelectionGroupSummary[]

Ek özellik grupları

​OptionGroupSummary[]

Varyant grupları

Ürün etiketleri

​OfferedProductSummary[]

Tavsiye edilen ürünler

​CombineProductSummary[]

Kombine ürünler

Özelleştirme grupları

​MidblockSummary

Vitrin bloğu objesi

​SeoSettingSummary
​ProductSummary[]

Varyant ürünler (ana ürün için)

updatedAt
​string · date-time

Kayıt son güncellenme tarihi

Example: 2018-02-21T15:01:03+0300
createdAt
​string · date-time

Kayıt oluşturulma tarihi

Example: 2018-02-21T09:36:03+0300
​ProductExtraFieldSummary[]
​DigitalProductSummary
targetKeyword
​string · maxLength: 255
solvedCount
​integer
seoTotalRuleCount
​integer
next
​string · writeOnly
prev
​string · writeOnly

Product DELETE

DELETE
https://magaza-adiniz.myideasoft.com
/admin-api/products/{id}
Bearer
or
OAuth 2.0

Product DELETE › path Parameters

id
​string · pattern: \d+ · required

Product DELETE › Responses

Silme isteği başarı ile sonuçlandı. (cevapta içerik bulunmaz.)

No data returned

Product ChangeCategoryAction PUT

PUT
https://magaza-adiniz.myideasoft.com
/admin-api/products/{id}/change_category
Bearer
or
OAuth 2.0

Product ChangeCategoryAction PUT › path Parameters

id
​string · pattern: \d+ · required

Product ChangeCategoryAction PUT › Responses

İşlem (GET veya PUT) başarı ile sonuçlandı.

No data returned

Product ShowcaseSortOrderUpdateAction PUT

PUT
https://magaza-adiniz.myideasoft.com
/admin-api/products/showcase_sort_order_update
Bearer
or
OAuth 2.0

Product ShowcaseSortOrderUpdateAction PUT › Responses

İşlem (GET veya PUT) başarı ile sonuçlandı.

No data returned

Product GetUsedIntegrationDistributors GET

GET
https://magaza-adiniz.myideasoft.com
/admin-api/products/integration_distributors
Bearer
or
OAuth 2.0

Product getUsedIntegrationDistributors

Product GetUsedIntegrationDistributors GET › Responses

İşlem (GET veya PUT) başarı ile sonuçlandı.

No data returned