T-SOFT/Storefront API/Müşteri Form Alanları

Müşteri Form Alanları

Üyelik ve profil formlarının dinamik alan yapılandırmasını döner. Alanlar, zorunluluk durumları ve seçenek listeleri mağazadan mağazaya değişir; formu bu yapılandırmadan dinamik olarak kur. Kaynak salt-okunurdur ve kimliği doğrulanmış müşteri token'ı gerektirir.

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

Listeleme

GET /customer-form-fields

curl -s 'https://<domain>/api/v3/storefront/account/2026-01/customer-form-fields?filter[formType]=register&filter[platform]=web' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>'

Örnek bir kayıt:

{
  "type": "customer-form-fields",
  "id": "gender",
  "attributes": {
    "title": "Cinsiyet",
    "fieldKey": "gender",
    "fieldType": "select",
    "isRequired": false,
    "options": ["Kadın", "Erkek", "Belirtmek istemiyorum"],
    "minLength": null,
    "maxLength": null,
    "listNo": 7
  }
}

Alanlar

Alan	Açıklama
`title`	Alanın görünen etiketi
`fieldKey`	Form gönderiminde kullanılacak alan anahtarı
`fieldType`	Alan tipi (metin, seçim vb.)
`isRequired`	Alan zorunlu mu?
`options`	Seçim tipli alanlar için seçenek listesi
`minLength`	Minimum karakter sayısı (varsa)
`maxLength`	Maksimum karakter sayısı (varsa)
`listNo`	Formdaki görüntüleme sırası

Filtreler

Filtre	Örnek	Davranış
`formType`	`filter[formType]=register`	Hangi formun alanları; değerler: `register`, `update`, `vendorRegister`
`platform`	`filter[platform]=web`	Hangi platformun alanları; değerler: `web`, `mobileApp`

formType değerleri: register (yeni üyelik), update (profil düzenleme), vendorRegister (bayi/satıcı kaydı). platform değerleri: web ve mobileApp. Formu üretmeden önce her iki filtreyi de bağlamına göre ayarla — aynı mağazada web ve uygulama alan kümeleri farklı olabilir.

Sıralama

Sort	Anlamı
`listNo`	Formdaki alan sırası

Varsayılan sıralama listNo.