GurStore Ürünleri için REST API Uç Noktaları

GurStore mağaza ürün uç noktaları tamamen herkese açıktır — bunları çağırmak için bir API belirteci veya herhangi bir kimlik doğrulama başlığı gerekmez. Bu, onları başsız mağazaları, statik site oluşturmayı, ürün listeleme sayfalarını ve kataloğunuzu sunucu tarafı oturum olmadan göstermek istediğiniz her bağlamı beslemek için ideal kılar. Her iki uç nokta da yalnızca aktif ürünleri döndürür; taslaklar ve devre dışı listeler otomatik olarak hariç tutulur.

Tüm ürünleri listele

Mağazanızdaki tüm aktif ürünlerin bir dizisini döndürür.

GET /api/store/products

Kimlik doğrulama: Gerekmez Sorgu parametreleri: Şu anda zorunlu bir sorgu parametresi yoktur. Ek filtreleme seçenekleri (kategoriye, fiyat aralığına veya etikete göre) gelecekteki API sürümlerinde eklenebilir.

Örnek istek

curl https://magazaniz.com/api/store/products \
  -H "Accept: application/json"

Örnek yanıt

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "name": "Pro License",
      "slug": "pro-license",
      "price": 29.99,
      "is_active": true
    },
    {
      "id": 2,
      "name": "Enterprise License",
      "slug": "enterprise-license",
      "price": 99.99,
      "is_active": true
    }
  ]
}

Yanıt alanları

string

İsteğin sonucunu belirtir. 200 yanıtında daima "success".

array

Ürün nesnelerinden oluşan bir dizi. Aktif ürün yoksa boş dizi döndürür.

integer

Ürünün benzersiz sayısal tanımlayıcısı.

string

Ürünün mağazanızda göründüğü şekliyle görünen adı.

string

Ürünün URL-güvenli tanımlayıcısı. GET /api/store/products/{slug} ile tek bir ürünü getirmek için bu değeri kullanın.

number

Mağazanızın yapılandırılmış para biriminde ondalık sayı olarak ürün fiyatı.

boolean

Ürünün aktif olup olmadığı. Pasif ürünler filtrelendiğinden liste yanıtlarında bu alan daima true.

Tek bir ürünü getir

URL slug’ıyla tanımlanan tek bir ürünü döndürür.

GET /api/store/products/{slug}

Kimlik doğrulama: Gerekmez

Yol parametreleri

string

required

Getirmek istediğiniz ürünün URL slug’ı. Bir ürünün slug’ını liste uç noktasındaki slug alanından veya GurStore panelinizde ürünün ayarları altından bulabilirsiniz.

Örnek istek

curl https://magazaniz.com/api/store/products/pro-license \
  -H "Accept: application/json"

Örnek yanıt

{
  "status": "success",
  "data": {
    "id": 1,
    "name": "Pro License",
    "slug": "pro-license",
    "price": 29.99,
    "is_active": true
  }
}

Yanıt alanları

string

İsteğin sonucunu belirtir. 200 yanıtında daima "success".

object

İstenen slug ile eşleşen tek bir ürün nesnesi.

integer

Ürünün benzersiz sayısal tanımlayıcısı.

string

Ürünün görünen adı.

string

Yolda ilettiğiniz değerle eşleşen, ürünün URL slug’ı.

number

Mağazanızın yapılandırılmış para biriminde ondalık sayı olarak ürün fiyatı.

boolean

Ürünün şu anda aktif ve satın alınabilir olup olmadığı.

Verilen slug’a sahip ürün yoksa veya devre dışı bırakılmışsa API 404 Not Found yanıtı döndürür. API açısından, kullanılamayan listelerin yanlışlıkla açığa çıkmasını önlemek için pasif ürünler yokmuş gibi ele alınır.

Genel Bakış

Mağaza (Storefront)

Müşteri API

Özel API v1

Webhooks

GurStore Ürünleri için REST API Uç Noktaları

Tüm ürünleri listele

Örnek istek

Örnek yanıt

Yanıt alanları

Tek bir ürünü getir

Yol parametreleri

Örnek istek

Örnek yanıt

Yanıt alanları

​Tüm ürünleri listele

​Örnek istek

​Örnek yanıt

​Yanıt alanları

​Tek bir ürünü getir

​Yol parametreleri

​Örnek istek

​Örnek yanıt

​Yanıt alanları

Tüm ürünleri listele

Örnek istek

Örnek yanıt

Yanıt alanları

Tek bir ürünü getir

Yol parametreleri

Örnek istek

Örnek yanıt

Yanıt alanları