Create a custom page

Requires write_page access scope.

For more info, refer to:

POST https://{handle}.myshopline.com/admin/openapi/v20260301/store/page/customize.json

handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .

Create a custom page for the store.

Request Headers

Content-Type string required

The field must be set to the fixed value application/json; charset=utf-8.
Authorization string required

The access token for the API resource. Refer to App authorization to obtain the access token, and then pass the obtained token in the Bearer format.
Example:

Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

Request Body

reqobject required

Request parameters.
author string required

The ID or name of the author for the custom page.
Example: Alvin
body_html string

The body content of the custom page, formatted in HTML.

The file size must not exceed 16MB.
Example: <p>We love to hear from you.</p>
handle string required

A unique semantic identifier for the custom page.
Example: contact-us
published_at string

The publication time of the custom page, which must not be earlier than the current time. If you schedule this page for future publication, specify this parameter and set published_status to false. Format: yyyy-MM-dd HH:mm:ss.SSS.
Example: 2023-09-11 16:49:35.120
published_status boolean

Whether to publish the custom page immediately.

true: Publish immediately.

false: Do not publish or schedule for future publication. To schedule publication, the published_at field must be specified.

Default value: true
template_name string

The name of the template used for the custom page.
Example: templates/page.contact.json
template_type integer

The template type used by the custom page. Valid values are:

0: Default theme template.

1: Public template, available for all themes.

2: App-defined theme template, only effective for the current theme.

Default value: 0
title string required

Title of the custom page.

Maximum length: 255
Example: Contact us
url string

Relative path of the custom page URL. Refer to Customize your URL for details on URL customization.

Maximum length: 512
Example: /pages/contact_us

Status Codes

For the complete list of codes and messages, see Http status code.

Response Headers

traceId

A globally unique identifier for the request. It is used to track the request flow throughout the system, allowing for easy location and debugging when issues arise.

Response Body

dataobject

Custom page information.
author string

The ID or name of the author for the custom page.
Example: Alvin
body_html string

The body content of the custom page, formatted in HTML.
Example: <p>We love to hear from you.</p>
created_at string

Creation time of the custom page. Format: yyyy-MM-dd HH:mm:ss.SSS.
Example: 2023-09-11 16:49:35.000
handle string

A unique semantic identifier for the custom page.
Example: contact-us
id string

The unique ID of the custom page.
Example: 6743314731912662424
published_at string

Publication time of the custom page. Format: yyyy-MM-dd HH:mm:ss.SSS.
Example: 2023-09-11 16:49:35.120
published_status boolean

Whether the custom page has been published.

true: Already published.

false: Not yet published.
store_id long

The unique ID of the store.
Example: 1730104825803
template_name string

Template name used for the custom page.
Example: templates/page.contact.json
title string

Title of the custom page.
Example: Contact us
updated_at string

Update time of the custom page. Format: yyyy-MM-dd HH:mm:ss.SSS.
Example: 2023-09-11 16:49:35.120
msg string

Response information, including the reason for success or failure.

API Explorer

Debugger

Examples

Base URL

https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

Authorization — header required

Body

Body required

{
  "req": {
    "author": "Alvin",
    "body_html": "<p>We love to hear from you.</p>",
    "handle": "contact-us",
    "published_at": "2023-09-11 16:49:35.120",
    "published_status": null,
    "template_name": "templates/page.contact.json",
    "template_type": null,
    "title": "Contact us",
    "url": "/pages/contact_us"
  }
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/store/page/customize.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'

Was this article helpful to you?

SHOPLINE

Legal