Ticaret
TürkçeEnglish

Dokümanlar

REST API

Mağaza kapsamlı REST API, OpenAPI ve problem+json.

Genel bakış

Ticaret API shop-scoped’tır. Çoğu uç shop_id / mağaza oturumu ister. Sürüm: 2026-07.

  • OpenAPI (makine okunur): GET {API}/openapi.json
  • Problem+json hata zarfı: type, title, status, detail
  • Mutasyonlarda staff CSRF cookie zorunlu

Kimlik

| Aktör | Cookie | Not |

|---|---|---|

| Personel | ticaret_staff | Admin / SDK |

| Müşteri | ticaret_customer | Vitrin hesap |

| Platform | ticaret_platform | platform-web |

Örnek

curl -sS "$API_URL/openapi.json" | head
curl -sS -H "Cookie: ticaret_staff=..." "$API_URL/products"

Parça OpenAPI uçları

Tam liste openapi.json içindedir. Öne çıkanlar:

  • Ürün / sipariş / müşteri
  • Sepet / checkout / ödeme webhook’ları
  • Tema kurulum / ayarlar
  • Eklenti grant / inceleme
  • e-Fatura / KVKK (TRC)

Gizli anahtarlar (vault) asla OpenAPI veya GET yanıtlarında dönmez.