Etibas API

Tedarikçi ve alıcı aynı platformdaysa veri HTTP üzerinden dolaşmaz; panel içinden doğrudan akar.

Kurulum (alıcı tarafında, 1 dakika)

1. Tedarikçi size Hesap ID ve Token verir (API Hesapları ekranından).
2. Panelinizde Eklentiler › Etibas Ağı'nı kurun; Firma (tedarikçinin firma kartı), Hesap ID, Token girin; teslimatı seçin: müşterime doğrudan (dropship) ya da bana.
3. Kaydedince bağlantı iki tarafta da görünür. Ürünler ilk eşitlemede gelir (Firmalar ekranından eşleştirilir), sonrasında değişiklikler anında yansır.

Ne olur?

Ortak kurallar

Uç ayrıntıları (OpenAPI)

Tam şema: openapi.yaml — aşağıda etkileşimli belge.

Olay olduğunda adresinize JSON POST edilir:

{
  "olay_id": "a1b2…",
  "tur": "urun.degisti",
  "tarih": "2026-10-10T14:05:12+03:00",
  "api_hesabi": "…",
  "yuk": { "urun_idler": ["URN001", "URN002"] }
}

Başlıklar: X-Etibas-Olay, X-Etibas-Olay-Id, X-Etibas-Imza = HMAC-SHA256(gövde, gizli anahtar) hex. 2xx dışı yanıtta 1 sn, 5 sn, 30 sn, 2 dk, 10 dk sonra yeniden denenir; 5 denemeden sonra olay /olaylar'da "basarisiz" görünür. Webhook'u PUT /webhook ile ya da panelden (API Hesapları › Webhook) açabilirsiniz.

$token = 'TOKEN';
$imlec = null; $urunler = [];
do {
    $url = 'https://api.etibas.com/v2/urunler?size=1000' . ($imlec ? '&imlec=' . urlencode($imlec) : '');
    $ch = curl_init($url);
    curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $token]]);
    $y = json_decode(curl_exec($ch), true);
    foreach ($y['veri'] ?? [] as $u) $urunler[] = $u;
    $imlec = $y['sonraki_imlec'] ?? null;
} while ($imlec);
echo count($urunler) . " ürün";

$govde = json_encode([
  'siparis_kodu' => 'WEB-10234', 'isim' => 'Ayşe Yılmaz', 'mail' => 'ayse@ornek.com', 'telefon' => '5321112233',
  'bilgiler' => [
    'fatura_isim' => 'Ayşe Yılmaz', 'fatura_adres' => 'Örnek Mah. 1. Sk. No:3', 'fatura_il_isim' => 'İstanbul', 'fatura_ilce_isim' => 'Kadıköy',
    'teslimat_isim' => 'Ayşe Yılmaz', 'teslimat_adres' => 'Örnek Mah. 1. Sk. No:3', 'teslimat_il_isim' => 'İstanbul', 'teslimat_ilce_isim' => 'Kadıköy',
  ],
  'kargo' => ['_id' => 'yurtici', 'isim' => 'Yurtiçi Kargo', 'barkod' => ''],
  'urunler' => [['_id' => 'URUN_ID', 'fiyat' => 1049.93, 'adet' => 1]],
]);
$ch = curl_init('https://api.etibas.com/v2/siparisler');
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_POSTFIELDS => $govde, CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $token, 'Content-Type: application/json']]);
$y = json_decode(curl_exec($ch), true);   // 201: $y['veri']['id'] · 409: aynı siparis_kodu · 422: $y['hata']['alanlar']

import requests
r = requests.get("https://api.etibas.com/v2/stoklar", headers={"Authorization": "Bearer TOKEN"})
for s in r.json()["veri"]:
    print(s["id"], s["stok"], s.get("alis", s["psf"]))

curl -H "Authorization: Bearer TOKEN" "https://api.etibas.com/v2/ben"
curl -H "Authorization: Bearer TOKEN" "https://api.etibas.com/v2/siparisler?guncellenme_gte=2026-10-10%2000:00:00"

search_after: yanıttaki değeri bir sonraki istekte gönderin; null dönünce bitti. v1'de hata kodları artık doğru HTTP durumlarıyla döner (403 token/IP, 404 uç, 409/422 sipariş).

Denemek için tanıtım hesabı (veriler örnektir, her gece yenilenir):

v1: https://api.etibas.com/demo/3f253c990fdd2e333bf8ed462591c563/urunler?size=5