跳到主要内容

概述

Ajax API 提供一套轻量级的 REST API endpoints，用于开发 Shoplazza 主题。

备注

Ajax API 只能由 Shoplazza 托管的主题使用。

使用场景​

Ajax API 的可能使用场景包括：

  • 将商品添加到购物车并更新购物车商品数量。
  • 展示相关商品推荐。
  • 在访客输入搜索关键词时提示商品和 collections。
  • 注册顾客、让顾客登录，以及管理顾客资料和地址。
  • 向顾客展示自己的订单和包裹物流状态。
  • 把博客文章、自定义页和导航菜单取到 section 里。
  • 在 JavaScript 中读取商品、专辑或店铺的元字段。

请参阅 Ajax API 参考文档，获取所有可用 API endpoints 的完整列表。

发起 API 请求​

Ajax API 接受四种类型的 HTTP 请求：

  • GET 请求：读取店铺数据，例如购物车、商品、专辑、顾客和订单
  • POST 请求：创建数据或提交表单，例如加购或让顾客登录
  • PATCH 请求：修改数据，例如购物车行项目或顾客地址
  • DELETE 请求：删除数据，例如购物车行项目或顾客地址

例如，要获取购物车的当前内容，请向店铺 /api/cart endpoint 发送客户端请求。

示例
fetch(window.SHOPLAZZA.routes.root + '/api/cart')
  .then(response => response.json())
  .then(data => { /* do something */});

多语言 URL​

当店铺面向国际市场或以多种语言销售时，可以为其生成动态 URL。使用 Ajax API 时，应使用动态的、区域感知的 URL，以便为访客提供与其所选语言和国家一致的体验。

全局值 window.SHOPLAZZA.routes.root 可在 JavaScript 中作为构建多语言 URL 的基础。该全局值始终以空字符串结尾，因此您可以放心地使用简单的字符串拼接来构建完整的 URL。

在此页面