REST API ile Sisteme Entegrasyon Rehberi

API Erisimi Nasil Etkinlestirilir?

Tedarikci veya bayi panelinde Ayarlar > API sekmesine gidin. Yeni API anahtari olusturun. Anahtar bir kez gosterilir, guvenli bir yerde saklayin.

1. Kimlik Dogrulama (JWT)

POST https://api.dropshipping.gen.tr/api/auth/api-token
{
  "api_anahtari": "YOUR_API_KEY"
}
Cevap: { "token": "eyJ..." }

Aldiginiz tokeni sonraki tum isteklerde Authorization header ile gonderin: Authorization: Bearer eyJ...

2. Urunleri Listeleme

GET /api/products?page=1&limit=50
Authorization: Bearer eyJ...

Sayfalama icin page ve limit parametrelerini kullanin. Filtreler: kategori_id, marka_id, durum.

3. Stok Guncelleme

PUT /api/products/:id/stok
Body: { "stok": 25 }

4. Siparis Cekme

GET /api/siparis?durum=onaylandi&from=2026-04-01

5. Webhook (yakinda)

Siparis, stok ve fiyat degisikliklerinde sisteminize POST istegi gonderilir. Webhook URL ayarlarini panelden yapin.

Rate Limit ve Kota

Standart paket: dakikada 60 istek, gunde 10.000 istek. Asildiginda 429 donus alirsiniz. Ust paketler icin iletisime gecin.

Hata Kodlari

• 401 - Token yok veya gecersiz
• 403 - Yetki yok (rol kontrolu)
• 404 - Kaynak bulunamadi
• 422 - Validation hatasi (response body icinde detay)
• 429 - Rate limit asildi
• 500 - Sunucu hatasi

Destek

API sorunlari icin Yardim Merkezi veya destek@dropshipping.gen.tr.