İçeriğe geç
EN Panele git
Webhook'lar

Webhook'lar

Webhook, bir olay olduğunda Bulutegra'nın sizin adresinize gönderdiği POST isteğidir. Böylece yeni siparişleri öğrenmek için API'yi sürekli yoklamanız gerekmez.

Webhook ekleme

  1. Ayarlar › Bulutegra API ve webhook › Webhook'lar bölümüne adresinizi yazın (yalnız https://).
  2. Almak istediğiniz olayları seçip Webhook ekle'ye basın.
  3. Gösterilen imza sırrını (whsec_…) kaydedin; yalnız bir kez gösterilir.
  4. Test gönder ile adresinize test olayı yollayıp bağlantıyı doğrulayın.

İstek

POST /bulutegra-webhook HTTP/1.1
Content-Type: application/json; charset=utf-8
User-Agent: Bulutegra-Webhook/1
X-Bulutegra-Olay: siparis.yeni
X-Bulutegra-Teslim: siparis_yeni_3f9c1a7e2b6d4c10
X-Bulutegra-Imza: sha256=5d2c…
{
  "olay": "siparis.yeni",
  "kimlik": "siparis_yeni_3f9c1a7e2b6d4c10",
  "zaman": "2026-10-07 10:45:00",
  "veri": {
    "kanal": "trendyol",
    "kanal_ad": "Trendyol",
    "siparis_no": "10000000001",
    "belge": "20000000001",
    "tarih": "2026-10-07 10:42:11",
    "durum": "Picking",
    "durum_kategori": "bekliyor",
    "tutar": 849.9,
    "para_birimi": "TRY",
    "adet": 2,
    "kalemler": [
      {
        "sku": "ABC-1001|SIYAH|M|",
        "barkod": "8680000000017",
        "adet": 2,
        "ad": "Örnek Ürün — Pamuklu Tişört, M"
      }
    ],
    "erp": {
      "yonetim": "bulutegra",
      "aktarildi": true,
      "erp_no": "1-S-1-000123"
    },
    "ilk_gorulme": "2026-10-07 10:43:02",
    "son_kontrol": "2026-10-07 11:20:45"
  }
}
AlanAçıklama
olayOlay adı — bkz. Olaylar
kimlikTeslim kimliği; aynı olay yeniden denenirse aynı kalır — tekrarları bununla ayıklayın
zamanOlayın üretildiği an
veriSipariş nesnesi (alanlar); webhook'larda müşteri adı yer almaz

Yanıtınız

İsteği aldığınızda 10 saniye içinde 2xx döndürün; ağır işi kuyruğunuza atıp hemen yanıt verin. Yanıt gövdesi okunmaz. Yönlendirmeler (3xx) izlenmez.

Son güncelleme: 2026-10-07