Kimlik doğrulama
Her istekte Bearer anahtarı. Anahtar mağazayı ve izinleri belirler.
Her isteğe Authorization başlığı ekle:
Authorization: Bearer mk_canli_8f3eK2…Anahtar hangi mağazaya aitse istek o mağazada çalışır; adreste mağaza adı geçmez.
Anahtar biçimi
| Önek | Nerede |
|---|---|
mk_canli_ + 32 karakter | Kendi mağazan. Gerçek siparişler, gerçek stok. |
mk_test_ + 32 karakter | Test mağazası. |
Anahtarı panelde Ayarlar → API anahtarları'ndan mağaza sahibi ya da yönetici oluşturur. Anahtar yalnız bir kez gösterilir; biz yalnız özetini saklarız, kaybedersen yenisini oluştur. Bir mağazada en çok 50 etkin anahtar olabilir. Kullanmadığın anahtarı aynı ekrandan iptal et.
Anahtarı tarayıcıya koyma
Canlı anahtar mağazanın verisine erişir. Yalnız sunucunda kullan; ön yüz koduna, mobil uygulamaya ya da Git deposuna koyma.
İzinler
Anahtarı oluştururken yalnız gereken izinleri seç. Yazma izni aynı kaynağın okumasını da kapsar
(urun:yazma → urun:okuma).
| İzin | Ne yapar |
|---|---|
urun:okuma / urun:yazma | Ürünler, varyantlar, kategoriler, koleksiyonlar, markalar |
stok:okuma / stok:yazma | Depo stokları, toplu stok |
fiyat:okuma / fiyat:yazma | Toplu fiyat, fiyat listeleri |
siparis:okuma / siparis:yazma | Siparişler, kargoya verme, iptal, not, iadeler |
musteri:okuma / musteri:yazma | Müşteriler ve müşteri grupları |
kampanya:okuma / kampanya:yazma | Kampanyalar ve indirim kodları |
icerik:okuma / icerik:yazma | Sayfalar ve menüler |
webhook:yonet | Webhook abonelikleri |
GET /v1/magaza her anahtarla açıktır ve anahtarın izinlerini döner.
Hatalar
| Durum | kod | Ne zaman |
|---|---|---|
| 401 | anahtar_yok | Başlık yok ya da biçimi yanlış |
| 401 | anahtar_gecersiz | Anahtar yok, iptal edilmiş ya da başka ortama ait |
| 403 | izin_yok | Anahtarda bu ucun izni yok |
| 403 | magaza_donduruldu | Mağaza dondurulmuş; API kapalı |