T-SOFT/Storefront API/Hesap

Hesap

customers kaynağı, oturum açmış müşterinin kendi hesabını yönetir. Koleksiyon uç noktası yoktur — yalnızca customers/me üzerinden çalışan üç özel yol vardır. Tüm istekler kimliği doğrulanmış müşteri token'ı gerektirir.

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

Hesabı görüntüleme

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

Örnek yanıt:

{
  "type": "customers",
  "id": "10432",
  "attributes": {
    "name": "Ayşe",
    "surname": "Yılmaz",
    "email": "ayse@example.com",
    "phone": "05551234567",
    "customerGroupId": 3,
    "taxOffice": "Kadıköy",
    "taxNumber": "1234567890",
    "companyName": "Örnek Ltd. Şti.",
    "kvkk": true
  }
}

Hesabı güncelleme

Değiştirmek istediğin alanları PATCH isteğinin JSON gövdesinde, data.attributes altında gönder. id gövdede me olmalıdır.

PATCH customers/me
curl -s -X PATCH 'https://<domain>/api/v3/storefront/account/2026-01/customers/me' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>' \
  -d '{
    "data": {
      "type": "customers",
      "id": "me",
      "attributes": {
        "name": "Ayşe",
        "surname": "Kaya",
        "phone": "05559876543"
      }
    }
  }'
Gövdeye yalnızca değiştirdiğin alanları koymak yeterlidir. Tüm alanlar yazılabilir olduğundan email gibi kimlik alanlarını değiştirirken çift doğrulama akışını uygulama tarafında sağlamayı unutma.

Hesabı silme

DELETE customers/me
curl -s -X DELETE 'https://<domain>/api/v3/storefront/account/2026-01/customers/me' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>'
Hesap silme storefront-account-deletion throttle kuralıyla sınırlandırılmıştır. Kısa aralıkla tekrarlanan silme istekleri 429 Too Many Requests ile reddedilir.

Alanlar

Bu kaynakta tüm alanlar yazılabilir; PATCH customers/me ile güncellenebilir.

AlanAçıklama
nameAd
surnameSoyad
emailE-posta adresi
phoneTelefon numarası
customerGroupIdMüşteri grubu id'si
taxOfficeVergi dairesi
taxNumberVergi numarası
companyNameFirma unvanı
kvkkKVKK aydınlatma onayı