Requires write_script_tags access scope.
For more info, refer to:
POST https://{handle}.myshopline.com/admin/openapi/v20260301/store/script_tags.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 new SCRIPT TAG
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
  • script_tagobject
    object
  • display_scope string
    Show range , online stores should include script pages . rms : online_store ( including home page , list page , detail page , shopping cart page , search page , 404 pages , custom page , blog collection , blog ) ;Checkout ( settlement page , including settlement three steps and status page ) ; all : ( script is included on the online storefront and order status page , including the upper two ranges )
    Example: all
  • event string
    The DOM event that triggers script loading, valid values are: onload
    Example: onload
  • src string required
    Remote URL script
    Example: https://djavaskripped.org/fancy.js
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
  • script_tagobject
    object
  • display_scope string
    Show range , online stores should include script pages . rms : online_store ( including home page , list page , detail page , shopping cart page , search page , 404 pages , custom page , blog collection , blog ) ;Checkout ( settlement page , including settlement three steps and status page ) ; all : ( script is included on the online storefront and order status page , including the upper two ranges )
    Example: all
  • event string
    DOM event that triggers script loading. Valid values: onload
    Example: onload
  • id string
    Identify script tag's ID
    Example: 61a75c4e9f8c201e6e9473e0
  • src string
    URL of the remote script
    Example: https://djavaskripped.org/fancy.js
  • updated_at string
    Date and time the script tag last updated (ISO 8601)
    Example: 2022-08-03T10:45:00+08:00
  • cache boolean
    Cache ID
  • created_at string
    Date and time the script tag created (ISO 8601)
    Example: 2022-08-03T10:45:00+08:00
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

header required

Body

required
{
  "script_tag": {
    "event": "onload",
    "src": "https://djavaskripped.org/fancy.js",
    "display_scope": "all"
  }
}

Language

curl --request POST \
--url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/store/script_tags.json \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'accept: application/json'
Examples
Create a script tag
Request
{
"script_tag": {
"src": "https://js.example.com/helloworld.js",
"display_scope": "all",
"event": "onload"
}
}
Response
{
"script_tag": {
"src": "https://js.example.com/helloworld.js",
"updated_at": "2023-09-11T15:53:52+08:00",
"cache": false,
"created_at": "2023-09-11T15:53:52+08:00",
"display_scope": "all",
"event": "onload",
"id": "64fec790e6b5eb49f64ae4d6"
}
}
Was this article helpful to you?