İçeriğe geç
0850 346 41 09[email protected]
Giriş Teklif iste

Genel API ile çalışmak

Genel API ile ürün, stok, sipariş, gönderi, iade ve soru işlerini kendi yazılımınızdan yaparsınız; kurallar panelle aynıdır.

  • API anahtarı olan yazılımlar

Genel API ile çalışmak nasıl yapılır?

Genel API ile ürün, stok, sipariş, gönderi, iade ve soru işlerini kendi yazılımınızdan yaparsınız; kurallar panelle aynıdır. Kimler yapabilir: API anahtarı olan yazılımlar. API anahtarını tarayıcıda çalışan koda, uygulama paketine ya da paylaşılan depoya koymayın; yalnız sunucu tarafında saklayın.

Bağlanmak

  1. Ayarlar > API anahtarları'nda yazılımınız için bir anahtar oluşturun. Listede her anahtarın ön eki 1 ve izinleri 2 görünür.

  2. İstekleri panel adresinizin /api/v1 yoluna gönderin, örneğin https://market.dblinx.net/api/v1/ben.

  3. Her isteğe Authorization: Bearer <anahtar> başlığını ekleyin 4. GET /v1/ben anahtarın izinlerini ve dakikalık sınırını döndürür; bağlantıyı bununla deneyin.

  4. Kullanılmayan anahtarı çöp kutusu simgesiyle iptal edin 3.

API anahtarları listesi: anahtar ön eki, izinler, iptal düğmesi ve yetkilendirme başlığı bilgisi (demo verisiyle)
  1. 1Anahtarın ön eki
  2. 2İzinler
  3. 3İptal et
  4. 4Yetkilendirme başlığı

Başlıca uçlar

  • GET /v1/urunler, GET /v1/urunler/{id}, POST /v1/urunler (stok koduna göre ekle ya da güncelle), PUT /v1/urunler/{id}/stok ({stok} ya da {fark}), DELETE /v1/urunler/{id}. Ürün yerine stok kodu da yazılabilir.
  • POST /v1/urunler/stok-fiyat: tek istekte en çok 500 ürünün stok ve fiyatı; hatalı kalem diğerlerini durdurmaz.
  • GET /v1/siparisler (imleçli, en yeni önce; durum, hesapId, baslangic, bitis), GET /v1/siparisler/{id}, POST …/hazirla, POST …/tedarik-edilemedi, POST …/gonderi, GET /v1/gonderiler/{id}/etiket.
  • GET /v1/iadeler, POST /v1/iadeler/{id}/karar, GET /v1/sorular, POST /v1/sorular/{id}/yanit, POST /v1/esitle.

Tekrar güvenliği, sınırlar ve hatalar

  • Yazma isteklerine Idempotency-Key başlığı ekleyin: ağ kesintisinden sonra aynı isteği aynı anahtarla yeniden gönderirseniz işlem ikinci kez yapılmaz, ilk yanıt döner. Anahtar 24 saat saklanır.
  • Anahtar başına dakikada 120 istek yapılabilir. Aşımda 429 ve Retry-After döner; kalan hak X-RateLimit-Remaining başlığındadır.
  • Hatalar {"error": "…", "message": "…"} biçimindedir. 403 forbidden anahtarın izni olmadığını, 423 salt_okunur hesabın kısıtlı olduğunu, 503 pazaryeri_gecici pazar yerinin geçici hatasını gösterir; 503'te bir süre sonra yeniden deneyin.
  • Sipariş listesinde toplam sayı yoktur; yanıttaki sonrakiImlec boşsa son sayfadasınız.
Dikkat API anahtarını tarayıcıda çalışan koda, uygulama paketine ya da paylaşılan depoya koymayın; yalnız sunucu tarafında saklayın.

İlgili sayfalar