Satış Temsilcileri
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
| Alan | Tip | Kural |
|---|---|---|
wsCode | string | Temsilcinin kayıt kodudur. Kayıt formunda seçilen temsilcinin bu değeri representativeCode olarak gönderilir. Tanımsızsa boş string (""). |
name | string | Temsilcinin adı. Boşsa boş string (""). |
surname | string | Temsilcinin soyadı. Boşsa boş string (""). |
email | string | Temsilcinin e-posta adresi. Boşsa boş string (""). |
Filtreler
| Parametre | Örnek | Davranış |
|---|---|---|
filter[id] | filter[id]=7,3 | Virgü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 | Örnek | Davranış |
|---|---|---|
sort | sort=name | Temsilci 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 kodu | Sebep |
|---|---|
| 400 | Geçersiz sorgu parametresi (tanınmayan alan seçimi, geçersiz filtre veya sıralama) |
| 405 | Yazma denemesi (POST/PATCH/DELETE) — kaynak salt okunurdur |
| 406 | Accept başlığı application/vnd.api+json değil |