# 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

## Bağlanmak

- 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.

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

- 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.

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

## 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

- API anahtarı oluşturmak

- Ortak stok nasıl çalışır