需要 read_page 权限点。
更多权限点使用信息,请参考:
POST https://{handle}.myshopline.com/admin/openapi/v20250601/store/page/customize/list.json
handle :店铺的唯一标识符,值为店铺域名的前缀。例如,域名为 open001.myshopline.com 的店铺,其 handleopen001
获取自定义页面列表(返回自定义路由)
请求头
  • Content-Type required
    字段值固定为application/json; charset=utf-8
  • Authorization string required
    资源的访问令牌。请参考 应用授权 获取访问令牌,然后将获取到的访问令牌以 Bearer 格式传入
    Example:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
请求体
  • reqobject
    请求参数
  • created_at_max string
    显示在此日期前创建的页面,格式:yyyy-MM-dd HH:mm
    Example: 2014-04-25T16:15:47-04:00
  • created_at_min string
    显示在此日期后创建的页面,格式:yyyy-MM-dd HH:mm
    Example: 2014-04-25T16:15:47-04:00
  • handle string
    自定义页面的handle
    Example: "pagecustomUrl"
  • page_num integer required
    页码
    Example: 1
  • page_size integer required
    显示条数,不能大于250条,默认50条
    Example: 50
  • published_at_max string
    显示在此日期前发布的页面
    Example: 2014-04-25T16:15:47-04:00
  • published_at_min string
    显示在此日期后发布的页面
    Example: 2014-04-25T16:15:47-04:00
  • published_status string
    发布状态,枚举值:any(全部);published(已发布);unpublished(未发布)
    Example: true
  • search_by_source integer
    是否根据来源查询,1(是);0(否)
    Example: 1
  • since_id long
    仅查询该ID之后的页面
  • sort_field integer
    排序字段,可选值:1(表示按照按更新时间);默认按id排序
    Example: 1
  • sort_type integer
    排序类型,可选值: 0(升序,默认); 1(降序)
    Example: 1
  • title string
    自定义页面的标题
    Example: "title"
  • updated_at_max string
    显示在此日期之前更新的页面,格式:yyyy-MM-dd HH:mm
    Example: 2014-04-25T16:15:47-04:00
  • updated_at_min string
    显示在此日期之后更新的页面,格式:yyyy-MM-dd HH:mm
    Example: 2014-04-25T16:15:47-04:00
响应
更多状态码信息请参考 HTTP 状态码

响应头
  • traceId
    traceId
响应体
  • dataobject
    响应信息
  • last_page boolean
    是否最后一页,true(是);false(否)
    Example: true
  • listobject[]
    自定义页面列表
  • author string
    自定义页面的作者
    Example: "Alvin"
  • body_html string
    自定义页面的内容
    Example: "content of the page"
  • created_at string
    创建时间,格式:yyyy-MM-dd HH:mm
    .SSS
    Example: "2024-06-20 17:50:45.460"
  • custom_urlobject
    店面上产品的自定义URL
  • is_customized string
    是否自定义
    Example: true
  • url string
    店面上的产品URL,大于等于0个字符,小于等于512个字符
    Example: "/custom-url"
  • handle string
    自定义页面的handle
    Example: "pagecustomUrl"
  • id string
    自定义页面的id
    Example: "6515896407215317133"
  • published_at string
    发布时间,格式:yyyy-MM-dd HH:mm
    .SSS
    Example: "2024-06-20 17:50:45.460"
  • published_status boolean
    是否发布
    Example: true
  • store_id long
    店铺id
  • template_name string
    模版名称
    Example: "templates/page.html"
  • template_type integer
    模版类型,可选值:1(店铺);2(主题)
    Example: 1
  • title string
    自定义页面的标题
    Example: "title"
  • updated_at string
    更新时间,格式:yyyy-MM-dd HH:mm
    .SSS
    Example: "2024-06-20 17:50:45.460"
  • page_num integer
    页码
    Example: 1
  • page_size integer
    页面大小
    Example: 50
  • total long
    总数量
    Example: 50
  • msg string
    错误信息
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601

ParamOptions

header required

Body

required
{
  "req": {
    "created_at_max": "2014-04-25T16:15:47-04:00",
    "created_at_min": "2014-04-25T16:15:47-04:00",
    "handle": "\"pagecustomUrl\"",
    "page_num": 1,
    "page_size": 50,
    "published_at_max": "2014-04-25T16:15:47-04:00",
    "published_at_min": "2014-04-25T16:15:47-04:00",
    "published_status": "true",
    "search_by_source": 1,
    "since_id": 0,
    "sort_field": 1,
    "sort_type": 1,
    "title": "\"title\"",
    "updated_at_max": "2014-04-25T16:15:47-04:00",
    "updated_at_min": "2014-04-25T16:15:47-04:00"
  }
}

Language

curl --request POST \
--url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/store/page/customize/list.json \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'accept: application/json'
这篇文章对你有帮助吗?