ezyMemo Developer Documentation

No payload required

window.parent.postMessage({ type: 'GET_SHOP_INFO' }, '*');

window.addEventListener('message', (e) => {
  if (e.data.type === 'SHOP_INFO_RESPONSE') {
    const shop = e.data.data;
    // shop.shop_name, shop.currency, shop.average_rating, etc.
  }
});

No payload required

window.parent.postMessage({ type: 'GET_THEME' }, '*');

window.addEventListener('message', (e) => {
  if (e.data.type === 'THEME_RESPONSE') {
    const { primary, secondary, accent } = e.data.data.colors;
    document.body.style.setProperty('--primary', primary);
  }
});

No payload required

window.parent.postMessage({ type: 'GET_CATEGORIES' }, '*');

window.addEventListener('message', (e) => {
  if (e.data.type === 'CATEGORIES_RESPONSE') {
    const categories = e.data.data;
    // [{ category_id, name, product_count }, ...]
  }
});

{ filters: { category_id?, search?, sort?, limit?, page? } }
// sort: 'price_asc' | 'price_desc' | 'newest'

window.parent.postMessage({
  type: 'GET_PRODUCTS',
  filters: { limit: 8, sort: 'newest' }
}, '*');

window.addEventListener('message', (e) => {
  if (e.data.type === 'PRODUCTS_RESPONSE') {
    const { products, total, page, totalPages } = e.data.data;
  }
});

{ sku: 'PRODUCT-SKU' }

window.parent.postMessage({
  type: 'GET_PRODUCT',
  sku: 'my-product-sku'
}, '*');

window.addEventListener('message', (e) => {
  if (e.data.type === 'GET_PRODUCT_RESPONSE') {
    const product = e.data.data;
    // product.variants[], product.attributes[], product.gallery_images[]
  }
});

{ productId: 123 }  // optional - omit for shop reviews

window.parent.postMessage({
  type: 'GET_PRODUCT_REVIEWS',
  productId: 123
}, '*');

window.addEventListener('message', (e) => {
  if (e.data.type === 'GET_PRODUCT_REVIEWS_RESPONSE') {
    const reviews = e.data.data;
    // [{ customer_name, rating, comment, created_at }, ...]
  }
});

No payload required

window.parent.postMessage({ type: 'GET_CART' }, '*');

window.addEventListener('message', (e) => {
  if (e.data.type === 'GET_CART_RESPONSE') {
    const { items } = e.data.data;
    // [{ product_id, name, price, quantity, image, sku }, ...]
  }
});

No payload required

window.parent.postMessage({ type: 'GET_NAVIGATION' }, '*');

window.addEventListener('message', (e) => {
  if (e.data.type === 'GET_NAVIGATION_RESPONSE') {
    const nav = e.data.data;
    // nav.header_nav_links, nav.footer_nav_links, nav.custom_pages
  }
});

{ productId: 123, quantity: 1 }
// OR { sku: 'PRODUCT-SKU', quantity: 1 }
// OR { product: { product_id, name, price, ... }, quantity: 1 }

// Simple product
window.parent.postMessage({
  type: 'ADD_TO_CART',
  sku: 'my-product',
  quantity: 1
}, '*');

// IMPORTANT: Check variant_count before calling ADD_TO_CART
// Products with variants will redirect to product page
if (product.variant_count > 0) {
  window.parent.postMessage({
    type: 'NAVIGATE',
    url: 'p/' + product.sku
  }, '*');
} else {
  window.parent.postMessage({
    type: 'ADD_TO_CART',
    product: product,
    quantity: 1
  }, '*');
}

Same as ADD_TO_CART

window.parent.postMessage({
  type: 'BUY_NOW',
  sku: 'my-product',
  quantity: 1
}, '*');

{ url: 'products' }  // internal path
// OR { url: 'https://example.com' }  // external URL

// Navigate to shop products page
window.parent.postMessage({
  type: 'NAVIGATE',
  url: 'products'
}, '*');

// Navigate to specific product
window.parent.postMessage({
  type: 'NAVIGATE',
  url: 'p/my-product-sku'
}, '*');

{ message: 'Hello!', variant: 'success' }
// variant: 'success' | 'error' | 'warning' | 'default'

window.parent.postMessage({
  type: 'SHOW_TOAST',
  message: 'Item added to cart!',
  variant: 'success'
}, '*');

{ height: 500 }  // height in pixels

// Usually automatic via ResizeObserver
// Manual override if needed:
window.parent.postMessage({
  type: 'IFRAME_RESIZE',
  height: document.body.scrollHeight
}, '*');