Storefront API রেফারেন্স

JavaScript Example

const response = await fetch(
  'https://storefront.iws-commerce.com/v1/stores/your-store-id/products'
);
const { products } = await response.json();

console.log(products);

Response Example

{
  "product": {
    "id": "prod_123abc",
    "title": "Organic Cotton T-Shirt",
    "description": "Comfortable and sustainable",
    "price": 1000,
    "compare_at_price": 1200,
    "currency": "BDT",
    "images": [
      {
        "url": "https://cdn.iws-commerce.com/products/tshirt-001.jpg",
        "alt": "Organic Cotton T-Shirt - Front View"
      },
      {
        "url": "https://cdn.iws-commerce.com/products/tshirt-002.jpg",
        "alt": "Organic Cotton T-Shirt - Back View"
      }
    ],
    "variants": [
      {
        "id": "var_001",
        "title": "Small / Green",
        "price": 1000,
        "available": true,
        "options": {
          "size": "Small",
          "color": "Green"
        }
      }
    ],
    "tags": ["organic", "sustainable", "cotton"],
    "available": true
  }
}

JavaScript Example

const response = await fetch(
  'https://storefront.iws-commerce.com/v1/stores/your-store-id/cart',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    }
  }
);

const { cart } = await response.json();
// Store cart.id in localStorage or cookies
localStorage.setItem('cart_id', cart.id);

JavaScript Example

const cartId = localStorage.getItem('cart_id');

const response = await fetch(
  `https://storefront.iws-commerce.com/v1/stores/your-store-id/cart/${cartId}/items`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      variant_id: 'var_001', 
      quantity: 2
    })
  }
);

const { cart } = await response.json();
console.log('Cart total:', cart.total);

Response Example

{
  "cart": {
    "id": "cart_xyz789",
    "items": [
      {
        "id": "item_001",
        "product_id": "prod_123abc",
        "variant_id": "var_001",
        "title": "Organic Cotton T-Shirt",
        "variant_title": "Small / Green",
        "quantity": 2,
        "price": 1000,
        "line_total": 2000,
        "image": "https://cdn.iws-commerce.com/products/tshirt-001.jpg"
      }
    ],
    "subtotal": 2000,
    "tax": 200,
    "shipping": 50,
    "total": 2250,
    "currency": "BDT",
    "item_count": 2
  }
}

JavaScript Example

const response = await fetch(
  'https://storefront.iws-commerce.com/v1/stores/your-store-id/checkout', 
  {
    method: 'POST', 
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      cart_id: 'cart_xyz789', 
      customer: {
        email: 'customer@example.com', 
        name: 'John Doe'
      },
      shipping_address: {
        line1: '123 Main St', 
        city: 'Khulna', 
        state: 'Khulna', 
        postal_code: '9000', 
        country: 'Bangladesh'
      },
      payment_method: 'bkash'
    })
  }
);

const { checkout } = await response.json();
// Redirect to checkout.url
window.location.href = checkout.url;

Installation

npm install @iws-commerce/storefront-sdk

Usage Example

import { IWSCommerce } from '@iws-commerce/storefront-sdk';

const store = new IWSCommerce({ storeId: 'your-store-id' });

// Fetch products
const products = await store.products.list();

// Add to cart
const cart = await store.cart.addItem({ variantId: 'var_001', quantity: 1 });

// Checkout
const checkout = await store.checkout.create({ cartId: cart.id, customer: { email: 'customer@example.com' } });