T-SOFT/Storefront API/Satış Temsilcileri

Satış Temsilcileri

Yetki:storefront:read — herkese açık, token isteğe bağlı.

Mağazanın satış temsilcilerini döner. Uygulama bununla kayıt formundaki "satış temsilciniz" seçim kutusunu doldurur; müşteri bir temsilci seçtiğinde onun wsCode değeri kayıt isteğine representativeCode olarak eklenir.

Bu özellik lisansa bağlıdır: mağazada temsilci yetkisi tanımlı değilse liste boş gelir. Uç, sürüm kökü altındadır: https://<domain>/api/v3/storefront/2026-01. Hem uygulama (app) token'ı hem müşteri token'ı okuyabilir; token gönderilmeden de yanıt verir. Bu kaynak salt okunurdur — yalnızca listeleme yapılır, tek kayıt / yazma ucu yoktur.

Listeleme

GET /representatives

curl "https://<domain>/api/v3/storefront/2026-01/representatives" \
  -H "Accept: application/vnd.api+json" \
  -H "Authorization: Bearer <access_token>"
{
  "jsonapi": {
    "version": "1.0"
  },
  "data": [
    {
      "type": "representatives",
      "id": "7",
      "attributes": {
        "wsCode": "TMS-014",
        "name": "Ayşe",
        "surname": "Yıldız",
        "email": "ayse.yildiz@example.com"
      }
    },
    {
      "type": "representatives",
      "id": "3",
      "attributes": {
        "wsCode": "TMS-002",
        "name": "Mehmet",
        "surname": "Öztürk",
        "email": "mehmet.ozturk@example.com"
      }
    }
  ]
}

Liste sayfalanmaz; eşleşen tüm temsilciler tek yanıtta döner. Yalnızca satış temsilcisi olarak işaretli, aktif temsilciler gelir; destek amaçlı iç kullanıcılar listeye girmez.

Alanlar

AlanTipKural
wsCodestringTemsilcinin kayıt kodudur. Kayıt formunda seçilen temsilcinin bu değeri representativeCode olarak gönderilir. Tanımsızsa boş string ("").
namestringTemsilcinin adı. Boşsa boş string ("").
surnamestringTemsilcinin soyadı. Boşsa boş string ("").
emailstringTemsilcinin e-posta adresi. Boşsa boş string ("").

Filtreler

ParametreÖrnekDavranış
filter[id]filter[id]=7,3Virgülle ayrılmış temsilci id listesi; yalnızca eşleşen temsilcileri döndürür. Tek id (filter[id]=7) ve dizi sözdizimi (filter[id][]=7&filter[id][]=3) da desteklenir.

Sıralama

ParametreÖrnekDavranış
sortsort=nameTemsilci adına göre artan sıralar; sort=-name azalan sıralar.

Varsayılan sıralama (sort verilmediğinde) ada göre artandır.

Kayıtla ilişkisi

Kayıt formunda temsilci seçimi bu listeden yapılır: müşteri bir temsilci seçtiğinde, seçilen temsilcinin wsCode değeri kayıt isteğine representativeCode alanı olarak eklenir (bkz. Üye Kaydı ve Parola Kurtarma). representativeCode opsiyoneldir; gönderilmezse müşteri temsilcisiz kaydolur. Geçersiz veya tanınmayan bir kod gönderilirse kayıt yine tamamlanır, müşteriye temsilci bağlanmaz.

Hatalar

Durum koduSebep
400Geçersiz sorgu parametresi (tanınmayan alan seçimi, geçersiz filtre veya sıralama)
405Yazma denemesi (POST/PATCH/DELETE) — kaynak salt okunurdur
406Accept başlığı application/vnd.api+json değil