Ücretsiz başla

API ve webhook

Siparişi kendi sistemine taşı.

REST API ile mağazanın verisini okursun. Webhook’lar bir sipariş geldiğinde ya da stok değiştiğinde senin adresine imzalı bildirim gönderir.

Ücretsiz başlaGeliştirici portalı

Kaydır

01 · Kapsamı seç

Anahtar yalnız izin verdiğin veriyi görür.

Volt Aksesuar siparişlerini muhasebe programına aktarıyor. Bunun için yalnız sipariş ve müşteri okuma izni olan bir anahtar açtı. Test anahtarı yalnız okuma yapar, canlı veriyi değiştirmez.

02 · Veriyi oku

Sipariş tutarı kuruşuyla gelir.

Tutarlar tam sayı ve para birimiyle döner, yuvarlama farkı çıkmaz. Dili ve para birimini istekte belirtebilirsin. Aynı POST isteğini tekrar gönderirsen işlem ikinci kez yapılmaz.

Örnek taslaktır, adres ve alanlar değişebilir.

03 · İmzayı doğrula

Bildirimin senden geldiğini kontrol et.

Her webhook gövdesi zaman damgasıyla birlikte gizli anahtarınla imzalanır. Sunucun imzayı doğrular, olay kimliğiyle aynı bildirimi iki kez işlemez. Gizli anahtarı yenilersen eskisi bir süre daha geçerli kalır.

Örnek taslaktır, değişebilir.

Kapsam

Neye ulaşabilirsin.

Okuma uçları hazır. Yazma uçlarının bir kısmı henüz yok.

  • Siparişler

    Sipariş, kargo, iade ve ödeme durumları. Kilitli kur ve ana para birimi karşılığı.

  • Ürün ve stok

    Ürün, varyant, kategori, marka ve depo bazında stok okuma.

  • Müşteriler

    Müşteri ve adres okuma. Yazma, süreli bir oturum anahtarıyla yapılır.

  • Kampanya ve içerik

    Kupon, kampanya, sayfa, blog yazısı, çeviri ve fiyat listeleri.

  • Webhook olayları

    Sipariş, ödeme, iade, ürün, stok ve müşteri olayları. Her olayın sürümlü şeması var.

  • Ürün ve stok yazmaHenüz yok

    Ürün oluşturma, güncelleme ve stok yazma uçlarının tamamı.

Ayrıntılar

Entegrasyon yazarken işine yarayacaklar.

Webhook teslimatı

Adresin hata dönerse gönderim aralıklarla tekrar denenir. Uzun süre yanıt alınamazsa adres kapatılır ve sana e-posta gelir.

  • Yalnız HTTPS adreslere gönderim
  • Teslimat geçmişinde istek, yanıt ve deneme sayısı
  • Tek bir teslimatı elle tekrar gönderme

Hata ve sınırlar

Hatalar tek biçimde döner: kod, mesaj, ayrıntı. İstek sınırına takılırsan yanıtta ne zaman tekrar deneyeceğin yazar.

Sürüm değişiklikleri

Kaldırılacak uçlar değişiklik günlüğünde duyurulur, yanıt başlıkları kaldırılma tarihini bildirir.

Sorular

Sık sorulanlar

Webhook’u test etmek için gerçek sipariş beklemem gerekiyor mu?

Gerekmez. Panelden seçtiğin adrese test olayı gönderebilirsin.

Stoğu ERP’den API ile güncelleyebilir miyim?

Stok okuma hazır. Stok ve ürün yazma uçlarının tamamı henüz yok.

Aynı olay iki kez gelirse ne olur?

Her bildirimde bir olay kimliği gelir. Daha önce işlediğin kimliği atlayarak çift kaydı önlersin.

API belgelerine nereden ulaşırım?

Panelde Ayarlar › Geliştirici ekranından açılır. Herkese açık geliştirici portalı henüz yok.

İlgili sayfalar

İlk webhook’unu bir test mağazasında kur.

Mağazanı aç, anahtarını ve webhook adresini ekle. 3 gün ücretsiz, sonrasında ilk 3 ay toplam 150 TL (KDV dahil, tek ödeme).

Ücretsiz başlaPaketleri gör