Başlarken
Hızlı başlangıç
1. Anahtar oluşturun
- Bulutegra panelinde Ayarlar › Bulutegra API ve webhook ekranını açın (yalnız hesap sahibi yönetici görür).
- Anahtara bir ad verin (ör. Depo yazılımı) ve kapsamı seçin: Temel kişisel veri içermez; Kişisel veri dahil siparişlerde müşteri adını da döndürür.
- Anahtar oluştur'a basın. Anahtar yalnız bir kez gösterilir; güvenli bir yere kaydedin.
!
Anahtarı tarayıcıda çalışan koda, mobil uygulamaya ya da herkese açık bir depoya koymayın. Sunucunuzda ortam değişkeni olarak tutun.
2. Bağlantıyı deneyin
export BULUTEGRA_ANAHTAR="btg_<hesap>_<anahtar>"
curl "https://panel.bulutegra.com/api/v1/ping" -H "Authorization: Bearer $BULUTEGRA_ANAHTAR"{
"ok": true,
"hesap": "ornekmagaza",
"kapsam": "temel",
"zaman": "2026-10-07 11:54:01",
"surum": "v1"
}3. Bugünün siparişlerini çekin
curl "https://panel.bulutegra.com/api/v1/siparisler?baslangic=2026-10-07&limit=50" \
-H "Authorization: Bearer $BULUTEGRA_ANAHTAR"import os, requests
r = requests.get(
"https://panel.bulutegra.com/api/v1/siparisler?baslangic=2026-10-07&limit=50",
headers={"Authorization": "Bearer " + os.environ["BULUTEGRA_ANAHTAR"]},
timeout=30,
)
r.raise_for_status()
print(r.json())const r = await fetch("https://panel.bulutegra.com/api/v1/siparisler?baslangic=2026-10-07&limit=50", {
headers: { Authorization: `Bearer ${process.env.BULUTEGRA_ANAHTAR}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());<?php
$ch = curl_init("https://panel.bulutegra.com/api/v1/siparisler?baslangic=2026-10-07&limit=50");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("BULUTEGRA_ANAHTAR")],
]);
$veri = json_decode(curl_exec($ch), true);Yanıttaki sonraki_imlec doluysa aynı isteği imlec=<değer> ile tekrarlayın; boş (null) olduğunda tüm sayfaları aldınız. Ayrıntı: Sayfalama.
4. Yoklamak yerine webhook kullanın
Yeni siparişleri sık sık sormak yerine webhook ekleyin: sipariş geldiğinde, durumu değiştiğinde ya da ERP'nize aktarıldığında adresinize imzalı bir istek gelir.
Son güncelleme: 2026-10-07