Public Konumlar

Aktif konumlari listeleme ve detay endpointleri.

Base URL: /api/public/locations
Yetkilendirme: X-Api-Key

bilgi

Controller AllowAnonymous olsa da tenant cozumleme icin X-Api-Key header'i gereklidir.

---

GET /

Aktif (isActive: true) konumlari filtreli ve sayfalanmis listeler.

Headers:

X-Api-Key: customer-api-key

Query Parametreleri:

Parametre	Tip	Varsayilan	Aciklama
page	int	1	Sayfa numarasi
pageSize	int	10	Sayfa basina kayit
search	string	—	address, groupName, title, name alanlarinda arama
groupName	string	—	Grup filtresi
countryId	Guid	—	Ulke filtresi
cityId	Guid	—	Il filtresi
districtId	Guid	—	Ilce filtresi
lang	string	varsayilan dil	Liste cevabinda secili dilde title/name

Response — 200 OK: PaginatedResult<LocationListResponse>

---

GET /{id}

Belirli bir aktif konumu getirir.

Query Parametreleri:

Parametre	Tip	Aciklama
lang	string	Istenen dil kodu

Response — 200 OK: LocationResponse

---

GET /geo/countries

Aktif ulke listesini getirir.

Response — 200 OK:

{
  "success": true,
  "data": [
    {
      "id": "country-id-...",
      "name": "Turkiye",
      "code": "TR"
    }
  ]
}

---

GET /geo/cities

Aktif il listesini getirir.

Query Parametreleri:

Parametre	Tip	Aciklama
countryId	Guid	Verilirse ilgili ulkeye gore filtreler

Response — 200 OK:

{
  "success": true,
  "data": [
    {
      "id": "city-id-...",
      "countryId": "country-id-...",
      "name": "Istanbul",
      "code": "34"
    }
  ]
}

---

GET /geo/districts

Aktif ilce listesini getirir.

Query Parametreleri:

Parametre	Tip	Aciklama
cityId	Guid	Verilirse ilgili ile gore filtreler

Response — 200 OK:

{
  "success": true,
  "data": [
    {
      "id": "district-id-...",
      "cityId": "city-id-...",
      "countryId": "country-id-...",
      "name": "Kadikoy",
      "code": "KAD"
    }
  ]
}

---

Olasi Hatalar

Kod	Durum
403	locations modulu tenant'a atanmamis
404	Konum bulunamadi veya aktif degil