{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Ana Sayfa","item":"https://sepivel.com"},{"@type":"ListItem","position":2,"name":"Dokümantasyon","item":"https://sepivel.com/docs"},{"@type":"ListItem","position":3,"name":"API & Builders","item":"https://sepivel.com/docs/api"}]}

SEPIVEL Builders Platformu

Storefront API & Geliştirici Dokümantasyonu

SEPIVEL'nin modern headless e-ticaret altyapısıyla kendi özel vitrininizi, mobil uygulamanızı veya ERP entegrasyonunuzu inşa edin.

1. Kimlik Doğrulama (Authentication)

Tüm API istekleri mağazanızın yönetim panelinden ürettiğiniz Bearer token veya API Key ile doğrulanır.

curl -X GET "https://api.sepivel.com/v1/products" \
  -H "Authorization: Bearer sepivel_live_sec_xxx" \
  -H "Content-Type: application/json"

2. Ürün ve Stok Sorgulama

Aktif ürün kataloğunuzu, varyantları ve anlık stok durumunu JSON formatında çekebilirsiniz.

// Örnek JSON Yanıtı (200 OK)
{
  "status": "success",
  "data": [
    {
      "id": "prod_87216",
      "name": "Oversize Keten Gömlek",
      "sku": "KTM-GMLK-01",
      "price": 899.90,
      "currency": "TRY",
      "stock_quantity": 42,
      "variants": [
        { "size": "S", "stock": 10 },
        { "size": "M", "stock": 18 },
        { "size": "L", "stock": 14 }
      ]
    }
  ]
}

3. Canlı Webhook Bildirimleri

Sipariş oluşturulduğunda, ödeme onaylandığında veya kargo takip numarası girildiğinde kendi sunucunuza anlık webhook alın:

order.createdYeni sipariş geldiğinde

payment.succeededSanal POS tahsilatında

shipment.dispatchedKargo barkodu basıldığında

İlk adım 20 dakika

Mağazanın bağımsız kanala uygunluğunu birlikte çıkaralım.

Mağazanı kur