​
Products

Products endpointleri mağazadaki ürünleri listelemek ve ürün detayına ulaşmak için kullanılır.

​
Ürün listeleme

curl "https://api.hemenmagaza.com/v1/products?limit=20&page=1" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

​
Filtreleme

Desteklenen query parametreleri:
  • search: Ürün adı, SKU veya slug üzerinde arama yapar.
  • category_id: Belirli kategoriye ait ürünleri döndürür.
  • page: Sayfa numarası.
  • limit: Sayfa başına kayıt sayısı.
Örnek: 
GET /products?search=tisort&category_id=12&page=1&limit=20

​
Sıralama

sort parametresi ile ürünleri sıralayabilirsiniz. 
GET /products?sort=price_asc
Desteklenen değerler:
  • newest
  • price_asc
  • price_desc
  • name_asc
  • name_desc

​
Pagination

Liste response içinde meta alanı döner. 
{
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 146,
    "total_pages": 8
  }
}

​
Örnek ürün response’u

{
  "id": 101,
  "sku": "HM-TSHIRT-001",
  "name": "Siyah Oversize Tişört",
  "slug": "siyah-oversize-tisort",
  "description": "Günlük kullanım için rahat kesim tişört.",
  "price": 599.9,
  "currency": "TRY",
  "stock": 24,
  "images": [
    "https://cdn.hemenmagaza.com/products/tshirt.webp"
  ],
  "status": "active",
  "created_at": "2026-06-03T10:00:00Z"
}