# İstek Yapma

:::note{title="Mağaza alan adınızı ayarlayın"}
Her istek **kendi mağazanızın** alan adına gider: `https://<mağaza>.myideasoft.com` ya da mağazanıza bağlı kendi alan adınız. Referanstaki örnekler `magaza-adiniz.myideasoft.com` yer tutucusunu gösterir; bir isteği denemek için **Test** düğmesine tıklayıp açılan penceredeki URL alanına kendi alan adınızı yazın — tarayıcınızda saklanır ve tüm isteklerde kullanılır. Endpoint URL'sinin yanındaki ayar simgesi de ("Edit server variables") aynı işi yapar.
:::

## Başlıklar

```http
Authorization: Bearer <access_token>
Content-Type: application/json
```

Gövde içeren isteklerde (POST/PUT) gövde her zaman JSON formatındadır.

## Sayfalama ve sıralama

Liste endpoint'leri aşağıdaki sorgu parametrelerini destekler:

| Parametre | Açıklama |
|---|---|
| `page` | Sayfa numarası (1'den başlar) |
| `limit` | Sayfa başına kayıt sayısı |
| `sort` | Sıralama alanı; azalan sıralama için alan adının başına `-` ekleyin (örn. `sort=-createdAt`) |

## Filtreler

| Parametre | Açıklama |
|---|---|
| `id` | Tekil kayıt kimliği |
| `ids` | Birden fazla kimlik (virgülle ayrılmış) |
| `sinceId` | Belirtilen kimlikten sonraki kayıtlar |
| `q` | Genel arama sorgusu |
| `s` | Metin araması |

## Toplam sayı

Çoğu liste endpoint'i `/count` varyantı sunar; aynı filtre parametreleriyle toplam kayıt sayısını döndürür (örn. `GET /admin-api/product/count`).

## Tarih formatları

- Tarih: `yyyy-mm-dd` (örn. `2026-01-01`)
- Tarih + saat: `yyyy-mm-dd hh:mm:ss` (örn. `2026-01-01 12:00:00`)

:::warning{title="Değer aralıkları"}
Alan bazlı kısıtlar (örn. `limit` üst sınırı) her endpoint'in referans sayfasında belirtilir.
:::
