T-SOFT/Storefront API/Adres Alanları

Adres Alanları

address-fields kaynağı, adres formunun yapılandırmasını verir: hangi alan görünür, hangisi zorunlu, uzunluk kuralları nedir. Adres oluşturma/güncelleme ekranını bu yapılandırmaya göre dinamik kur. Salt-okunur bir kaynaktır; index ve show destekler. Kimliği doğrulanmış müşteri token'ı gerektirir.

Yetki:storefront:account — müşteri token'ı zorunlu.

Listeleme

GET address-fields

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

Örnek bir alan yapılandırması:

{
  "type": "address-fields",
  "id": "taxNumber",
  "attributes": {
    "title": "Vergi Numarası",
    "isVisible": true,
    "isRequired": false,
    "minLength": 10,
    "maxLength": 11,
    "listNo": 14
  }
}

Kaydın id değeri (taxNumber gibi) doğrudan Adresler kaynağındaki alan adına karşılık gelir; formunu bu eşleşmeyle kur.

Tek alan

GET address-fields/:id

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

Alanlar

Bu kaynaktaki tüm alanlar salt-okunur form yapılandırma değerleridir.

Alan	Açıklama
`title`	Alanın form etiketi; isteğin diline göre yerelleştirilir
`isVisible`	Alan formda gösterilsin mi?
`isRequired`	Alan zorunlu mu?
`minLength`	En az karakter sayısı
`maxLength`	En çok karakter sayısı
`listNo`	Formdaki görüntüleme sırası

Sıralama

Varsayılan sıralama listNo alanına göre artan yöndedir; formu bu sıraya göre diz.

Sort	Anlamı
`listNo`	Form sırası (varsayılan)

isVisible: false dönen alanları formda hiç gösterme. isRequired ve minLength/maxLength değerlerini mağazadan mağazaya değişebileceği için sabit değere gömme — her zaman bu kaynaktan oku. Aynı şey title için de geçerlidir: etiketi istemcide sabitleme, mağaza kendi dil kopyasında değiştirebilir.