需要 write_products 权限点。
更多权限点使用信息,请参考:
POST https://{handle}.myshopline.com/admin/openapi/v20210901/products/smart_collections.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
请求体
  • smart_collectionobject required
    智能分类相关信息
  • bannerobject
    分类banner图
  • alt string
    分类banner图alt信息
    Example: 我是banner图片alt
  • src string
    分类banner图src地址
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • body_html string
    分类描述
    Example: we always listen to our customers and our community
  • disjunctive boolean
    智能分类框定商品的条件之间的关系 true:商品符合任意一个条件,即可被纳入该智能分类中 false:商品必须满足所有条件必须全符合,才可被纳入该智能分类中
    Example: true
  • handle string
    分类Handle
    Example: 我是一份分类handle
  • imageobject
    分类图片
  • alt string
    图片alt
    Example: 我是分类图片alt
  • src string
    图片地址
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • published_scope string
    设置发布范围,值为「web」时表示在线商店
    Example: web
  • rulesobject[] required
    智能添加条件
  • column string required
    条件变量,商品标题: title,售价: sale_price,原价: compared_at_price,标签: tag,库存: inventory,供应商: vendor,重量: variant_weight,规格名称: variant_title,创建时间: created_at,销售: sales, 浏览量: view,加购量: add_to_cart,商品类型: product_category
    Example: tag
  • condition string
    对应条件变量的值
    Example: tag1
  • relation string required
    判断语句, 等于
    不等于
    开头为
    结尾为
    包含
    不包含
    大于
    小于
    Example: equals
  • sort_order string
    排序方式, 热销
    产品名称从A-Z
    产品名称从Z- A
    更新时间新→旧
    更新时间旧→新
    自定义
    Example: updated-asc
  • title string required
    分类的标题
    Example: 我是一个分类标题
响应
更多状态码信息请参考 HTTP 状态码

响应头
  • traceId
    traceId
响应体
  • smart_collectionobject
    智能分类信息
  • bannerobject
    分类banner
  • alt string
    图片alt
    Example: 我是banner图片alt
  • src string
    图片地址
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • body_html string
    分类描述
    Example: 我是分类描述
  • created_at string
    创建时间
    Example: 2021-09-03T14:11:54+00:00
  • disjunctive boolean
    条件间关系
    Example: true
  • handle string
    分类handle
    Example: 我是分类handle
  • id string
    分类id
    Example: 123
  • imageobject
    分类图片
  • alt string
    图片alt
    Example: 我是分类图片alt
  • src string
    图片地址
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • published_at string
    发布时间
    Example: 2021-09-03T14:11:54+00:00
  • published_scope string
    发布范围,值为「web」时表示在线商店
    Example: web
  • rulesobject[]
    智能添加条件
  • column string
    条件变量
    Example: tag
  • condition string
    对应条件变量的值
    Example: tag1
  • relation string
    判断语句
    Example: equals
  • sort_order string
    排序方式
    Example: updated-asc
  • template_path string
    主题模板
    Example: templates/sortation/detail.json
  • title string
    分类标题
    Example: 我是分类title
  • updated_at string
    更新时间
    Example: 2021-09-03T14:11:54+00:00
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20210901

ParamOptions

— header required

Body

required
{
  "smart_collection": {
    "banner": {
      "alt": "我是banner图片alt",
      "src": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png"
    },
    "body_html": "we always listen to our customers and our community",
    "disjunctive": true,
    "handle": "我是一份分类handle",
    "image": {
      "alt": "我是分类图片alt",
      "src": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png"
    },
    "published_scope": "web",
    "rules": [
      {
        "column": "tag",
        "condition": "tag1",
        "relation": "equals"
      }
    ],
    "sort_order": "updated-asc",
    "title": "我是一个分类标题"
  }
}

Language

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

Error loading component.

Error loading component.