GET, POST,
PUT, DELETE) gönderirsiniz ve her yanıt JSON olarak geri döner.
Temel URL (Base URL)
Tüm API istekleri şu temel URL’ye yapılır:magazaniz.com yerine gerçek GurStore alan adınızı yazın. Burada belgelenen tüm uç noktalar bu temel
URL’ye görelidir.
İstek Biçimi
Bir istek gövdesi gönderirken (POST, PUT veya PATCH istekleri için) JSON olarak kodlayın ve
Content-Type başlığını buna göre ayarlayın:
GET istekleri için sorgu parametreleri standart URL kodlamasını izler. Özel bir serileştirme gerekmez.
Yanıt Biçimi
GurStore API’sinden gelen her yanıt bir JSON nesnesi döndürür. Üst düzey yapı her zaman, isteğin sonucunu belirten birstatus alanı içerir.
Başarılı yanıt biçimi:
Hız Sınırlama (Rate Limiting)
GurStore, platform kararlılığını korumak için tüm API uç noktalarında hız sınırları uygular. Belirli bir pencerede izin verilen istek sayısını aşarsanız API429 Too Many Requests yanıtı döndürür.
Bir 429 aldığınızda isteklerinizi duraklatın ve üstel geri çekilme (exponential backoff) ile yeniden
deneyin — kısa bir süre bekleyin, ardından istek başarılı olana kadar her yeniden denemede bekleme
süresini iki katına çıkarın. Yanıtta varsa Retry-After başlığına uyun; yeniden denemeden önce tam olarak
kaç saniye beklemeniz gerektiğini söyler.
Hata Kodları
GurStore API, her isteğin sonucunu belirtmek için standart HTTP durum kodlarını kullanır. Aşağıdaki tablo, karşılaşabileceğiniz her kodu ve bağlamdaki anlamını listeler.API’yi Keşfedin
Kimlik Doğrulama
Bearer belirteçleri oluşturmayı ve isteklerinizi Laravel Sanctum ile doğrulamayı öğrenin.
Mağaza API'si
Başsız mağazanızı besleyen herkese açık ürün uç noktalarına göz atın — kimlik doğrulama gerekmez.
Müşteri API'si
Sepet içeriğini yönetin, kupon uygulayın ve kimliği doğrulanmış müşteri oturumuyla etkileşin.
Özel API v1
Ödeme isteklerini gönderin, ödemeleri işleyin ve dijital sipariş teslimatını tetikleyin.