查询商品专辑列表

GET 
/openapi/2022-01/collections

根据商品 ID、专辑名称、更新时间等筛选条件分页查询商品专辑列表。

请求

Query参数

ids string

指定要查询的专辑 ID 列表。

title string

按专辑名称模糊筛选。

updated_at_min string

筛选最后更新时间不早于该时间点的专辑，例如：2018-10-01T16:15:47-04:00。

updated_at_max string

筛选最后更新时间不晚于该时间点的专辑，例如：2018-10-01T16:15:47-04:00。

product_id string

商品 UUID，用于筛选包含该商品的专辑。

page int32

Page number; Must be greater than or equal to 1. Default value: 1.

limit int32

limit collection result per page; Must be between 1 and 100 (inclusive). Default value: 10.

响应

200

200

application/json

数据结构

数据结构

collections object[]
Array [
idstring
示例： a60fe556-43ad-4e07-9125-507ac1bf71f7
titlestring
示例： Test-Collection
descriptionstring
示例： Desc
handlestring
示例： test-collection
smartboolean
默认值： true
示例： false
image object
srcstring
示例： //cdn.shoplazza.com/9de53f9726576696b318a8d95c0946cb.jpeg
widthinteger
默认值： 0
示例： 1920
heightinteger
默认值： 0
示例： 1080
altstring
示例：
pathstring
示例： 9de53f9726576696b318a8d95c0946cb.jpeg
seo_titlestring
示例： seo_title
seo_descriptionstring
示例： Desc
seo_keywordsstring
示例： test
sort_orderstring
示例： title-asc
created_atstring
示例： 2024-04-16T10:31:13Z
updated_atstring
示例： 2024-04-16T10:31:13Z
]

示例

{
  "collections": [
    {
      "id": "a60fe556-43ad-4e07-9125-507ac1bf71f7",
      "title": "Test-Collection",
      "description": "Desc",
      "handle": "test-collection",
      "smart": false,
      "image": {
        "src": "//cdn.shoplazza.com/9de53f9726576696b318a8d95c0946cb.jpeg",
        "width": 1920,
        "height": 1080,
        "alt": "",
        "path": "9de53f9726576696b318a8d95c0946cb.jpeg"
      },
      "seo_title": "seo_title",
      "seo_description": "Desc",
      "seo_keywords": "test",
      "sort_order": "title-asc",
      "created_at": "2024-04-16T10:31:13Z",
      "updated_at": "2024-04-16T10:31:13Z"
    }
  ]
}

Result

{
    "collections": [
        {
            "id": "a60fe556-43ad-4e07-9125-507ac1bf71f7",
            "title": "Test-Collection",
            "description": "Desc",
            "handle": "test-collection",
            "smart": false,
            "image": {
                "src": "//cdn.shoplazza.com/9de53f9726576696b318a8d95c0946cb.jpeg",
                "width": 1920,
                "height": 1080,
                "alt": "",
                "path": "9de53f9726576696b318a8d95c0946cb.jpeg"
            },
            "seo_title": "seo_title",
            "seo_description": "Desc",
            "seo_keywords": "test",
            "sort_order": "title-asc",
            "created_at": "2024-04-16T10:31:13Z",
            "updated_at": "2024-04-16T10:31:13Z"
        }
    ]
}

422

422

application/json

数据结构

数据结构

errorsstring[]

示例

{
  "errors": [
    "UpdatedAtMin time format error"
  ]
}

Result

{
  "errors": [
    "UpdatedAtMin time format error"
  ]
}