上传商品或规格封面，不能用来上传执照或客服二维码

POST/api/v1/catalogs/{id}/images

认证请求头 Authorization: Bearer <访问令牌>，访问令牌用设备码换取，不要向用户要密码、短信验证码或 API Key
权限商家，需要 product:write 才能修改商品、图片或店铺介绍

路径参数

path

idstring必填

目录 ID

路径示例

/api/v1/catalogs/cat_example/images

请求体

multipart/form-data

只接受 JPEG、PNG 或 WebP，同一商家 60 秒最多 30 次

filebinary必填

图片文件

取值范围: 字节数 <= 5 MiB

请求示例

file: <file>

响应

201

application/json

成功时 code 为 200，资源在 data

idstring必填

图片 ID

urlstring必填

本站 /media/{id} 的绝对地址

content_typestring必填

图片类型

byte_sizeinteger必填

字节数

响应示例

{
  "id": "id_example",
  "url": "string",
  "content_type": "string",
  "byte_size": 1
}