T-SOFT/Storefront API/Adresler

Adresler

addresses kaynağı, oturum açmış müşterinin adres defterini yönetir ve tam CRUD destekler. Tüm istekler kimliği doğrulanmış müşteri token'ı gerektirir.

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

Listeleme

GET addresses

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

Örnek bir adres kaydı:

{
  "type": "addresses",
  "id": "8842",
  "attributes": {
    "title": "Ev",
    "fullname": "Ayşe Yılmaz",
    "address": "Bağdat Cad. No:12 D:4",
    "postCode": "34710",
    "mobilePhone": "05551234567",
    "homePhone": "",
    "countryCode": "TR",
    "country": "Türkiye",
    "cityCode": "34",
    "city": "İstanbul",
    "townCode": "1234",
    "town": "Kadıköy",
    "districtCode": "5678",
    "district": "Caferağa",
    "provinceCode": "",
    "province": "",
    "company": "",
    "taxOffice": "",
    "taxNumber": "",
    "identityNumber": "*******1234",
    "isCompanyActive": false,
    "hasEInvoice": false,
    "isDefaultInvoice": true,
    "nationality": 0
  }
}

Adres oluşturma

POST addresses

curl -s -X POST 'https://<domain>/api/v3/storefront/account/2026-01/addresses' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>' \
  -d '{
    "data": {
      "type": "addresses",
      "attributes": {
        "title": "Ev",
        "fullname": "Ayşe Yılmaz",
        "address": "Bağdat Cad. No:12 D:4",
        "postCode": "34710",
        "mobilePhone": "05551234567",
        "countryCode": "TR",
        "cityCode": "34",
        "townCode": "1234",
        "districtCode": "5678",
        "isDefaultInvoice": true
      }
    }
  }'

Ülke/il/ilçe/mahalle alanlarını kod ile gönder (countryCode, cityCode, townCode, districtCode). Bunların metin karşılıkları (country, city, town, district) sunucu tarafından çözülür ve salt-okunurdur — gövdeye yazılsa bile yok sayılır.

Güncelleme

PATCH addresses/:id

curl -s -X PATCH 'https://<domain>/api/v3/storefront/account/2026-01/addresses/8842' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>' \
  -d '{
    "data": {
      "type": "addresses",
      "id": "8842",
      "attributes": {
        "title": "Yeni Ev",
        "mobilePhone": "05559876543"
      }
    }
  }'

Silme

DELETE addresses/:id

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

Alanlar

Alanların çoğu yazılabilir. Salt-okunur ve gizli alanlar aşağıda ayrıca işaretlenmiştir.

Alan	Açıklama
`title`	Adres etiketi (Ev, İş vb.)
`fullname`	Ad soyad
`address`	Açık adres
`postCode`	Posta kodu
`mobilePhone`	Cep telefonu
`homePhone`	Sabit telefon
`countryCode`	Ülke kodu (yazılır)
`country`	Ülke adı — salt-okunur, koddan çözülür
`cityCode`	İl kodu (yazılır)
`city`	İl adı — salt-okunur, koddan çözülür
`townCode`	İlçe kodu (yazılır)
`town`	İlçe adı — salt-okunur, koddan çözülür
`districtCode`	Mahalle/semt kodu (yazılır)
`district`	Mahalle/semt adı — salt-okunur, koddan çözülür
`provinceCode`	Bölge/eyalet kodu
`province`	Bölge/eyalet adı
`company`	Firma unvanı
`taxOffice`	Vergi dairesi
`taxNumber`	Vergi numarası
`identityNumber`	TCKN — yazmada tam değer gönderilir; okumada maskeli döner (son 4 hane açık)
`isCompanyActive`	Kurumsal fatura aktif mi?
`hasEInvoice`	E-fatura mükellefi mi?
`isDefaultInvoice`	Varsayılan fatura adresi mi?
`nationality`	Uyruk kodu

`identityNumber` semantiği

identityNumber (T.C. kimlik numarası) yazma tarafında tam değer olarak gönderilir ve saklanır; okuma tarafında ise maskelenmiş döner:

Son 4 hane açık kalır, öncesi * ile maskelenir — örn. *******1234.
4 karakter veya daha kısa bir değer tamamen maskelenir (her karakter *).
Boş veya tanımsız değer olduğu gibi döner ("" / null), maske uygulanmaz.

Maskeleme yalnızca okuma tarafındadır; alan POST/PATCH isteğinde tam değeriyle gönderilir. Bir adresi güncellerken kimlik numarasını değiştirmeyecekseniz, okumada gelen maskeli değeri geri göndermeyin — aksi hâlde maskeli metin gerçek kimlik numarasının yerine yazılır. Değeri değiştirmiyorsanız identityNumber alanını PATCH gövdesine hiç koymayın.