跳到主要内容

自定义页

Page API 用于获取店铺的自定义页列表,以及单个自定义页的 HTML 内容。两个 endpoint 匿名访客都可以调用。

所有 Ajax API 请求应使用多语言 URL,以便为访客提供一致的体验。

获取店铺自定义页列表

GET /{locale}/api/front/pages

获取店铺的自定义页列表,包含每个页面的内容和 SEO 字段。

请求示例

fetch(window.SHOPLAZZA.routes.root + '/api/front/pages?page=1&per_page=10')
.then((response) => response.json())
.then((data) => {
// do something...
});

请求参数

    pagenumber

    返回第几页结果。

    per_pagenumber

    每页返回的页面数,默认 10。

响应

    data object

    响应数据主体。

    pagenumber

    当前页码。

    per_pagenumber

    每页返回的记录数。

    pages object[]

    自定义页列表。

  • Array [
  • idnumber

    自定义页的 ID。

    store_idnumber

    对象所属店铺的 ID。

    originstring

    页面的来源。

    titlestring

    自定义页的标题。

    contentstring

    页面的 HTML 内容。

    statusnumber

    自定义页的状态,1 表示启用。

    created_atstring

    创建时间(ISO-8601 格式)。

    updated_atstring

    最后更新时间(ISO-8601 格式)。

    independent_seoboolean

    是否独立管理 SEO 设置。

    urlstring

    自定义页的相对地址。

    meta_titlestring

    页面元信息中的 SEO 标题。

    meta_keywordstring

    页面元信息中的 SEO 关键词。

    meta_descriptionstring

    页面元信息中的 SEO 描述。

  • ]
  • countnumber

    返回的自定义页数量。

    has_morenumber

    是否还有更多记录。

    msgstring

    响应返回的结果说明。

    statenumber

    请求结果标识,success0 表示请求成功。

获取单个自定义页

GET /{locale}/api/front/pages/{page_id}

按 id 获取单个自定义页。

请求示例

fetch(window.SHOPLAZZA.routes.root + '/api/front/pages/13594997')
.then((response) => response.json())
.then((data) => {
// do something...
});

请求参数

    page_idnumber

    自定义页的 id。

响应

    data object

    响应数据主体。

    idnumber

    自定义页的 ID。

    store_idnumber

    对象所属店铺的 ID。

    originstring

    页面的来源。

    titlestring

    自定义页的标题。

    contentstring

    页面的 HTML 内容。

    statusnumber

    自定义页的状态,1 表示启用。

    created_atstring

    创建时间(ISO-8601 格式)。

    updated_atstring

    最后更新时间(ISO-8601 格式)。

    independent_seoboolean

    是否独立管理 SEO 设置。

    urlstring

    自定义页的相对地址。

    meta_titlestring

    页面元信息中的 SEO 标题。

    meta_keywordstring

    页面元信息中的 SEO 关键词。

    meta_descriptionstring

    页面元信息中的 SEO 描述。

    msgstring

    响应返回的结果说明。

    statenumber

    请求结果标识,success0 表示请求成功。