T-SOFT/Storefront API/Şubeler

Şubeler

Mağazanın fiziksel şubelerini döndürür. Her şube adres, iletişim ve konum (enlem/boylam) bilgisini içerir. Salt-okunur katalog kaynağıdı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ı.

Listeleme

GET /branch-offices

curl -s 'https://<domain>/api/v3/storefront/2026-01/branch-offices' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>'

Örnek bir şube kaydı:

{
  "type": "branch-offices",
  "id": "7",
  "attributes": {
    "name": "Merkez Şube",
    "address": "Örnek Mah. Örnek Cad. No:1",
    "country": "Türkiye",
    "city": "İstanbul",
    "district": "Kadıköy",
    "neighbourhood": "Örnek Mahallesi",
    "phone": "+90 216 000 00 00",
    "email": "merkez@ornek.com",
    "latitude": 40.9901,
    "longitude": 29.0289,
    "hasLocation": true,
    "imageUrl1": "https://<domain>/Data/EditorFiles/subeler/merkez-1.jpg",
    "imageUrl2": "",
    "imageUrl3": "",
    "imageUrl4": "",
    "imageUrl5": ""
  }
}

Tek kayıt

GET /branch-offices/{id}

curl -s 'https://<domain>/api/v3/storefront/2026-01/branch-offices/7' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>'

Alanlar

Alan	Açıklama
`name`	Şube adı
`address`	Açık adres
`country`	Ülke
`city`	Şehir
`district`	İlçe
`neighbourhood`	Mahalle
`phone`	Telefon
`email`	E-posta
`latitude`	Enlem
`longitude`	Boylam
`hasLocation`	Konum bilgisi tanımlı mı?
`imageUrl1` … `imageUrl5`	Şube görsellerinin tam URL'leri, yoksa boş string

Filtreler

Filtre	Örnek	Davranış
`id`	`filter[id]=7,8`	Verilen id'lerle sınırlar (virgülle çoklu)
`city`	`filter[city]=İstanbul`	Şehre göre eşleştirir
`district`	`filter[district]=Kadıköy`	İlçeye göre eşleştirir

Sıralama

Sort	Anlamı
`name`	Alfabetik
`listNo`	Yönetim panelinden verilen liste sırası

hasLocation false olan şubeler için latitude/longitude anlamlı olmayabilir; haritada işaretlemeden önce bu alanı kontrol et.