T-SOFT/Storefront API/Teslimat Slotları

Teslimat Slotları

Bir teslimat bölgesi için uygun gün ve saat aralıklarını döndürür. Her slot tarih, gün, saat aralığı, durum ve kapasite kalemlerini içerir. Salt-okunur bir kaynaktır. Erişim için okuma token'ı gerekir: Authorization: Bearer <TOKEN> ve Accept: application/vnd.api+json başlıklarını gönder.

Yetki:storefront:read — herkese açık, token isteğe bağlı.

Lisans gerekir. Bu uç yalnızca mağaza kargo servisi ve mobil uygulama lisansı aktifse yanıt verir; aksi halde 404 döner.

Bu kaynak yalnızca listeleme (index) destekler; tek kayıt uç noktası yoktur. Ayrıca teslimat slotları lisansı gerektirir; lisans aktif değilse uç nokta 404 döner.

Listeleme

Slotlar bölge kodları ile filtrelenerek istenir:

GET /delivery-slots

curl -s 'https://<domain>/api/v3/storefront/2026-01/delivery-slots?filter[countryCode]=TR&filter[cityCode]=34&filter[townCode]=1234&filter[districtCode]=5678' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>'

Örnek bir slot kaydı:

{
  "type": "delivery-slots",
  "id": "2026-01-20_10-12",
  "attributes": {
    "date": "2026-01-20",
    "dayOfWeek": "Salı",
    "time": "10:00 - 12:00",
    "status": "available",
    "items": []
  }
}

Alanlar

Alan	Açıklama
`date`	Teslimat tarihi
`dayOfWeek`	Haftanın günü
`time`	Saat aralığı
`status`	Slot durumu (uygun/dolu vb.)
`items`	Slota ait kalemler

Filtreler

Filtre	Örnek	Davranış
`countryCode`	`filter[countryCode]=TR`	Ülke koduna göre daraltır
`cityCode`	`filter[cityCode]=34`	Şehir koduna göre daraltır
`townCode`	`filter[townCode]=1234`	İlçe/kasaba koduna göre daraltır
`districtCode`	`filter[districtCode]=5678`	Semt/mahalle koduna göre daraltır