API Referansı

Tüm API istekleri mağaza domaininiz üzerinden GraphQL uç noktasına gönderilir:

Örnek istek

POST https://magazaniz.bakal.tr/graphql
Content-Type: application/json

Müşteri oturumu gerektiren işlemler (sepet, sipariş, hesap) için önce giriş yapılır; dönen token sonraki isteklerde Authorization başlığında gönderilir.

Örnek istek

mutation {
  customerLogin(input: {
    email: "[email protected]"
    password: "********"
  }) {
    accessToken
    tokenType
  }
}

Ürün listesini ve ürün detayını sorgulayın. Ürünler url_key ile adreslenir.

Örnek istek

query {
  allProducts(input: [
    { key: "page", value: "1" }
    { key: "limit", value: "12" }
  ]) {
    paginatorInfo { total currentPage }
    data {
      id
      sku
      name
      urlKey
      priceHtml { finalPrice }
    }
  }
}

Sepete ürün ekleme, adres ve ödeme yöntemi kaydetme ve sipariş oluşturma akışı checkout mutation'ları ile yürütülür.

Örnek istek

mutation {
  addItemToCart(input: {
    productId: 1
    quantity: 2
  }) {
    cart {
      id
      itemsCount
      grandTotal
    }
  }
}