T-SOFT/Admin API/Katalog

Katalog

Kapsam: okuma için read_products, yazma için write_products. Tedarikçiler read_suppliers ister. Söz dizimi için Sorgu Parametreleri.

Ürün, varyant, kategori ve marka okuma Ürünler sayfasındadır. Bu sayfa ürünün çevresindeki tanımları anlatır.

Kategoriler

Uç	Metot	Kapsam
`catalog/categories`	`GET`	`read_products`
`catalog/categories`	`POST`	`write_products`
`catalog/categories/{id}`	`GET`, `PATCH`, `DELETE`	`read_products` / `write_products`

POST /catalog/categories

curl -X POST 'https://magaza.com/api/v3/admin/2026-01/catalog/categories' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -d '{"data": {"type": "categories", "attributes": {"name": "Cüzdanlar", "parentId": 42}}}'

Alan	Açıklama
`name`	Kategori adı
`code`	Kategori kodu
`parentId`	Üst kategori; kök kategori için `0`
`slug`, `seoTitle`, `seoDescription`	Vitrin adresi ve SEO alanları
`shortDescription`	Kısa açıklama
`listOrder`	Sıra
`visibility`	Vitrinde görünürlük
`showOnMobile`	Mobil uygulamada görünür mü

Filtreler: id, parentId, rootOnly, visible, showOnMobile. İlişkiler: parent, children.

Ürünler yalnız alt kategorisi olmayan (yaprak) kategorilere atanabilir.

Kategori ağacı

Tüm kategorileri iç içe tek yanıtta döner; menü ya da eşleme ekranı kurarken tek tek kategori çekmek yerine bunu kullanın.

GET /catalog/category-trees

curl 'https://magaza.com/api/v3/admin/2026-01/catalog/category-trees' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json'

{
  "data": [
    {
      "type": "category-trees",
      "id": "351",
      "attributes": {
        "name": "Aksesuar",
        "code": "T351",
        "parentCategoryId": 0,
        "hasChild": 1,
        "children": [ { "id": 352, "name": "Cüzdanlar", "children": [] } ]
      }
    }
  ]
}

Modeller

catalog/models: okuma read_products, yazma write_products. Alanlar: name, description, isPassive, listNo, seoLink. Filtreler: id, name, seoLink, isPassive.

Varyant grupları

Renk, beden gibi seçenek gruplarının ve değerlerinin tanımı. Ürünün varyantlarının kendisi Ürünler → Varyantlar altındadır.

Uç	Alanlar	Filtreler
`catalog/variant-groups`	`groupName`, `name`	—
`catalog/variant-group-options`	`groupId`, `name`, `colorCode`, `listNo`	`groupId`

Okuma read_products, yazma write_products.

Ürün görselleri

Uç	Metot	Açıklama
`catalog/product-images`	`GET`	Görselleri listeler; `filter[productId]` ile daraltın
`catalog/product-images/-actions/upload`	`POST`	Görsel yükler
`catalog/product-images/{id}`	`PATCH`	Sırayı ya da varyant bağını değiştirir
`catalog/product-images/{id}`	`DELETE`	Görseli siler

Yükleme multipart/form-data gövdesiyle yapılır:

POST /catalog/product-images/-actions/upload

curl -X POST 'https://magaza.com/api/v3/admin/2026-01/catalog/product-images/-actions/upload' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json' \
  -F 'productId=45789' \
  -F 'img1=@kapak.jpg'

Alan	Açıklama
`productId`	Ürün
`img1`	Dosya; jpeg, jpg, png, webp ya da gif, en fazla 3 MB
`subProductId`	Görseli bir varyanta bağlar
`preserveQuality`	`true` ise görsel yeniden sıkıştırılmaz

Aynı dosya aynı ürüne ikinci kez yüklenirse 422 döner. Görseli bir adresten indirme ucu yoktur; dosyayı kendiniz indirip yükleyin. Okuma read_products, yazma write_products ister.

Koleksiyonlar

catalog/collections: vitrinde elle ya da kurala göre ürün gruplayan koleksiyonlar. Okuma read_products, yazma write_products. Ürün listesi items ilişkisinden gelir.

Tedarikçiler

catalog/suppliers (yalnız okuma, read_suppliers). Alanlar: name, code, taxAdmin, taxNumber, address, city, phone, web, approval. Filtreler: id, name, approval.