查询文件列表

GET 
/openapi/2022-01/file

分页返回文件列表。

请求

Query参数

page int32
Page number; Defaults to 1 if not specified. Must be a positive integer.
默认值： 1
limit int32
The number of files to retrieve per page. Defaults to 20 if not specified. Must be greater than 0 and less than or equal to 300.
默认值： 20
folder string
文件夹。
默认值： product

响应

200

200

application/json

数据结构

数据结构

files object[]
Array [
upload_linkstring
示例： https://cdn.shoplazza.com/7ebb4faa8d92e1d627edf9ca61a98993.png
file_uristring
示例： 7ebb4faa8d92e1d627edf9ca61a98993.png
folderstring
示例： upload
sizeinteger
默认值： 0
示例： 6842
typestring
示例： image/png
origin_linkstring
示例：
descstring
示例：
aspect_ratiostring
示例： 1.2500000
widthinteger
默认值： 0
示例： 250
heightinteger
默认值： 0
示例： 200
created_atstring
示例： 2024-04-23T09:32:57+08:00
updated_atstring
示例： 2024-04-23T09:32:57+08:00
]

示例

{
  "files": [
    {
      "upload_link": "https://cdn.shoplazza.com/7ebb4faa8d92e1d627edf9ca61a98993.png",
      "file_uri": "7ebb4faa8d92e1d627edf9ca61a98993.png",
      "folder": "upload",
      "size": 6842,
      "type": "image/png",
      "origin_link": "",
      "desc": "",
      "aspect_ratio": "1.2500000",
      "width": 250,
      "height": 200,
      "created_at": "2024-04-23T09:32:57+08:00",
      "updated_at": "2024-04-23T09:32:57+08:00"
    }
  ]
}

Result

{
    "files": [
        {
            "upload_link": "https://cdn.shoplazza.com/7ebb4faa8d92e1d627edf9ca61a98993.png",
            "file_uri": "7ebb4faa8d92e1d627edf9ca61a98993.png",
            "folder": "upload",
            "size": 6842,
            "type": "image/png",
            "origin_link": "",
            "desc": "",
            "aspect_ratio": "1.2500000",
            "width": 250,
            "height": 200,
            "created_at": "2024-04-23T09:32:57+08:00",
            "updated_at": "2024-04-23T09:32:57+08:00"
        },
        {
            "upload_link": "https://cdn.shoplazza.com/652c51e6ea5273f8e0b5c3a30b62fd57.jpeg",
            "file_uri": "652c51e6ea5273f8e0b5c3a30b62fd57.jpeg",
            "folder": "url_upload",
            "size": 0,
            "type": "image/jpg",
            "origin_link": "",
            "desc": "",
            "aspect_ratio": "1.5032680",
            "width": 690,
            "height": 459,
            "created_at": "2024-04-23T09:25:54+08:00",
            "updated_at": "2024-04-23T09:25:54+08:00"
        }
    ]
}

400

400

text/plain

数据结构

数据结构

errorsstring[]

示例

{
  "errors": [
    "Unauthorized"
  ]
}

Result

{
  "errors": ["Unauthorized"]
}

422

422

application/json

数据结构

数据结构

errorsstring[]

示例

{
  "errors": [
    "limit must be greater than 0"
  ]
}

Result

{
  "errors": ["limit must be greater than 0"]
}