T-SOFT/Admin API/Mağaza

Mağaza

İletişim bilgileri

Kapsam:read_store_settings.

config/settings uygulamalara yalnız mağazanın iletişim ve sosyal medya ayarlarını açar. Fatura, kargo etiketi ya da e-postada mağaza bilgisini göstermek için kullanın.

GET /config/settings

curl 'https://magaza.com/api/v3/admin/2026-01/config/settings?filter[key]=IletisimBilgiFirma' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json'

Her kayıtta key ayarın anahtarı, value değeridir. Okunabilen anahtarlar:

Anahtar	İçerik
`IletisimBilgiFirma`, `IletisimBilgiFirmaAdres`, `IletisimAdres`	Firma unvanı ve adresi
`IletisimBilgiTelefon`, `IletisimBilgiFaks`, `IletisimBilgiEPosta`	Telefon, faks, e-posta
`IletisimBilgiIl`, `IletisimBilgiIlce`, `IletisimBilgiUlke`	İl, ilçe, ülke
`IletisimBilgiVergiDairesi`, `IletisimBilgiVergiNumarasi`	Vergi dairesi ve numarası
`IletisimBilgiYetkiliKisi`	Yetkili kişi
`IletisimBilgiTicaretSicilNo`, `IletisimBilgiMernisNo`, `IletisimBilgiKepAdresi`	Sicil, MERSİS ve KEP
`FacebookSayfaAdresi`, `TwitterSayfaAdresi`, `InstagramAdresi`, `YoutubeAdresi`	Sosyal medya
`WhatsappSatisNumarasi`	WhatsApp satış hattı
`MusteriHizmetleriSayfasi`	Müşteri hizmetleri sayfası

Listede olmayan anahtarlar yanıtta yer almaz. Ayar yazma uygulamalara açık değildir.

Diller

config/languages (read_store). Alanlar: code, name, nativeName, isDefault, status, isRtl. Filtreler: status, isDefault. Yalnız mağazada açık dilleri almak için filter[status]=1.

Para birimleri

config/currencies: okuma read_store, kur güncelleme write_currencies.

Alan	Açıklama
`code`, `name`, `symbol`	Para birimi
`rateType`	Kur kaynağı
`rateBank`, `rateManuel`	Bankadan gelen ve elle girilen kur
`fromBank`	Kur bankadan mı alınıyor
`gapPercentage`	Kura eklenen yüzde
`defaultCurrency`	Mağazanın varsayılan para birimi
`display`	Vitrinde gösteriliyor mu

write_currencies hassas bir kapsamdır: kur değişikliği tüm fiyatları etkiler.

config/regions: ülke, il ve ilçe tanımları; kargo bölgelerinin regionCode değeri buradan gelir. Okuma read_shipping, yazma write_shipping. Alanlar: code, name, regionType, top (üst bölge), isActive, cargoZone. Filtreler: id, code, name, regionType, top, isActive.

İzleme kodları

Vitrine kendi script'inizi (analitik, piksel, sohbet balonu) eklemek için.

Kapsam: okuma read_tracking_codes, ekleme/güncelleme/silme write_tracking_codes. Uygulamanız yalnız kendi eklediği kodları görür ve değiştirebilir. Uygulama kaldırıldığında eklediği kodlar silinir.

POST /config/tracking-codes

curl -X POST 'https://magaza.com/api/v3/admin/2026-01/config/tracking-codes' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -d '{
    "data": {
      "type": "tracking-codes",
      "attributes": {
        "description": "Ornek Analitik",
        "code": "<script src=\"https://cdn.ornek.com/t.js\" async></script>",
        "codeType": 1,
        "listNo": 50
      }
    }
  }'

Alan	Zorunlu	Açıklama
`description`	Evet	Panelde görünen ad
`code`	Evet	Eklenecek HTML/script
`codeType`	Evet	Kod türü; paneldeki izleme kodu türleriyle aynı değerler
`listNo`	Evet	Sıra; mağazada tekil olmalı
`status`	Hayır	Açık/kapalı
`webviewStatus`	Hayır	Mobil uygulama içi görünümde de çalışsın mı
`consentPurposes`	Hayır	Kodun bağlı olduğu çerez onayı amacı

code içindeki harici script adresleri herkese açık bir alan adında olmalı ve mağazanın içerik güvenliği politikası (CSP) açıksa o listede bulunmalıdır; aksi halde 422 döner.