初始化文件分段上传任务

需要 write_files 权限点。

更多权限点使用信息，请参考：

POST https://{handle}.myshopline.com/admin/openapi/v20260301/files/upload.json

handle ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 open001.myshopline.com 的店铺，其 handle 是 open001 。

启动多个文件的分阶段上传任务。此 API 将返回后续上传操作所需的上传凭据。

注意：接口内测中，若需使用该接口，请联系客户经理开通白名单。

请求头

Content-Type string required

字段值固定为 application/json; charset=utf-8。
Authorization string required

资源的访问令牌。参考应用授权获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。
例子:

Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

请求体

file_infoobject[] required

文件参数。
file_name string required

文件的名称。
最大长度限制：255
例子: file_name
file_size long

文件的大小（以字节为单位）。
当上传的资源为视频时必传。
例子: 300
mime_type string required

文件的 MIME 类型。有效枚举值包含：

image/jpeg

image/png

image/bmp

image/webp

image/svg+xml

image/x-icon

video/mp4

video/webm

video/quicktime

application/pdf

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

text/csv

application/vnd.openxmlformats-officedocument.wordprocessingml.document

font/ttf

font/woff

font/otf

font/sfnt

application/font-sfnt

audio/mpeg

text/html

text/javascript

application/javascript

text/css

application/json

application/xml

text/xml

text/plain

application/octet-stream

application/x-rar-compressed

application/zip

例子: string

状态码

更多状态码信息，参考 HTTP 状态码。

响应头

traceId

请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。

响应体

signsobject[]

文件的签名信息。
access_id string

文件的签名 access key。
例子: LTAI5tRrVqCocJKdSpEovixm
call_back string

文件的回调参数。
例子: eyJjYWxsYmFja0JvZHkiOiJidWNrZXQ9JHtidWNrZXR9Jm9iamVjdD0ke29iamVjdH0mc2l6ZT0ke3NpemV9JmNvbnRlbnRUeXBlVHlwZT0ke2NvbnRlbnRUeXBlVHlwZX0mZm9ybWF0PSR7aW1hZ2VJbmZvLmZvcm1hdH0mYml6dHlwZT1cIm9wZW5hcGlTdGFzaENoYW5nZUxpbmtcIiIsImNhbGxiYWNrQm9keVR5cGUiOiJhcHBsaWNhdGl
host string

文件的上传地址。
例子: https://sl-resource-tmp-sg.s3.xxx.com
key string

文件的相对路径。
例子: temp/file/store/1626235806828/6991265004189666341/image.jpg
policy string

文件的签名策略信息。
例子: eyJleHBpcmF0aW9uIjoiMjAyNi0wNS0xMlQwODo1Mjo1NloiLCJjb25kaXRpb25zIjpbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsMCwyMDk3MTUyMF0sWyJlcSIsIiRrZXkiLCJ0ZW1wL2ZpbGUvc3RvcmUvMTYyNjIzNTgwNjgyOC82OTkxMjY1MDA0MTg5NjY2MzQxLzAwMDQ5ZWEzNDQ4ZTQzMWM4YTRiYzVh
signature string

文件的签名。
例子: 6+YHcWnLhu0YofPIzAQUaZ9kKZI=
url string

预占文件访问链接。
例子: https://sl-resource-tmp-sg.s3-ap-southeast-1.xxx.com/temp%2Ffile%2Fstore%2F1672369729606%2F6995259736342668404%2Fimage.png?Expires=1747882880&OSSAccessKeyId=LTAI5tNjm7fr4EUCoEps4UPE&Signature=kLIWPCVwWTQMZcHUWyszjoH4DPM%3D

API Explorer

调试台

示例代码

Base URL

https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

Authorization — header required

Body

Body required

{
  "file_info": [
    {
      "file_name": "file_name",
      "file_size": 300,
      "mime_type": "string"
    }
  ]
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/files/upload.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'

Examples

初始化文件分段上传任务

Request

{
  "file_info": [
    {
      "file_name": "my video",
      "file_size": "2000",
      "mime_type": "video/mp4"
    },
    {
      "file_name": "my image",
      "file_size": "50",
      "mime_type": "image/png"
    }
  ]
}

Response

{
  "signs": [
    {
      "access_id": "LTAI5tNjm7fr4EUCoEps4UPE",
      "call_back": "eyJjYWxsYmFja0JvZHkiOiJidWNrZXQ9JHtidWNrZXR9Jm9iamVjdD0ke29iamVjdH0mbWltZVR5cGU9JHttaW1lVHlwZX0mc2l6ZT0ke3NpemV9JmNvbnRlbnRUeXBlVHlwZT0ke2NvbnRlbnRUeXBlVHlwZX0mZm9ybWF0PSR7aW1hZ2VJbmZvLmZvcm1hdH0mYml6dHlwZT1cIm9wZW5hcGlTdGFzaENoYW5nZUxpbmtcIiIsImNhbGxiYWNrQm9keVR5cGUiOiJhcHBsaWNhdGlvbi9qc29uIiwiY2FsbGJhY2tVcmwiOiJodHRwczovL2FwaS1vc3Nub3RpZnktc2ctcHJldmlldy5teXNob3BsaW5lLmNvbS9hcGkvc2lnbmF0dXJlL29zcy9wb3N0L25vdGlmeSJ9Cg==",
      "host": "https://sl-resource-tmp-sg.s3.xxx.com",
      "key": "temp/file/store/1672369729606/6995259736325891187/video.mp4",
      "policy": "eyJleHBpcmF0aW9uIjoiMjAyNS0wNS0yMlQwMzowMToyMFoiLCJjb25kaXRpb25zIjpbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsMCwyMDk3MTUyMF0sWyJlcSIsIiRrZXkiLCJ0ZW1wL2ZpbGUvc3RvcmUvMTY3MjM2OTcyOTYwNi82OTk1MjU5NzM2MzI1ODkxMTg3L3ZpZGVvLm1wNCJdLFsiaW4iLCIkY29udGVudC10eXBlIixbInZpZGVvL21wNCJdXSxbImVxIiwiJGNhbGxCYWNrIiwiZXlKallXeHNZbUZqYTBKdlpIa2lPaUppZFdOclpYUTlKSHRpZFdOclpYUjlKbTlpYW1WamREMGtlMjlpYW1WamRIMG1iV2x0WlZSNWNHVTlKSHR0YVcxbFZIbHdaWDBtYzJsNlpUMGtlM05wZW1WOUptTnZiblJsYm5SVWVYQmxWSGx3WlQwa2UyTnZiblJsYm5SVWVYQmxWSGx3WlgwbVptOXliV0YwUFNSN2FXMWhaMlZKYm1adkxtWnZjbTFoZEgwbVltbDZkSGx3WlQxY0ltOXdaVzVoY0dsVGRHRnphRU5vWVc1blpVeHBibXRjSWlJc0ltTmhiR3hpWVdOclFtOWtlVlI1Y0dVaU9pSmhjSEJzYVdOaGRHbHZiaTlxYzI5dUlpd2lZMkZzYkdKaFkydFZjbXdpT2lKb2RIUndjem92TDJGd2FTMXZjM051YjNScFpua3RjMmN0Y0hKbGRtbGxkeTV0ZVhOb2IzQnNhVzVsTG1OdmJTOWhjR2t2YzJsbmJtRjBkWEpsTDI5emN5OXdiM04wTDI1dmRHbG1lU0o5Q2c9PSJdLFsiaW4iLCIkeC1vc3MtY29udGVudC10eXBlIixbImZvcm0tZmllbGQtbnVsbCJdXV19Cg==",
      "signature": "yZ7+COvtdMCuVlTLJNcjZWsiONw=",
      "url": "https://sl-resource-tmp-sg.s3-ap-southeast-1.xxx.com/temp%2Ffile%2Fstore%2F1672369729606%2F6995259736325891187%2Fvideo.mp4?Expires=1747882880&OSSAccessKeyId=LTAI5tNjm7fr4EUCoEps4UPE&Signature=PfJxZps6aSlO7%2FROX3r9ePiBAls%3D"
    },
    {
      "access_id": "LTAI5tNjm7fr4EUCoEps4UPE",
      "call_back": "eyJjYWxsYmFja0JvZHkiOiJidWNrZXQ9JHtidWNrZXR9Jm9iamVjdD0ke29iamVjdH0mbWltZVR5cGU9JHttaW1lVHlwZX0mc2l6ZT0ke3NpemV9JmNvbnRlbnRUeXBlVHlwZT0ke2NvbnRlbnRUeXBlVHlwZX0mZm9ybWF0PSR7aW1hZ2VJbmZvLmZvcm1hdH0mYml6dHlwZT1cIm9wZW5hcGlTdGFzaENoYW5nZUxpbmtcIiIsImNhbGxiYWNrQm9keVR5cGUiOiJhcHBsaWNhdGlvbi9qc29uIiwiY2FsbGJhY2tVcmwiOiJodHRwczovL2FwaS1vc3Nub3RpZnktc2ctcHJldmlldy5teXNob3BsaW5lLmNvbS9hcGkvc2lnbmF0dXJlL29zcy9wb3N0L25vdGlmeSJ9Cg==",
      "host": "https://sl-resource-tmp-sg.s3.xxx.com",
      "key": "temp/file/store/1672369729606/6995259736342668404/image.png",
      "policy": "eyJleHBpcmF0aW9uIjoiMjAyNS0wNS0yMlQwMzowMToyMFoiLCJjb25kaXRpb25zIjpbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsMCwxMDQ4NTc2MF0sWyJlcSIsIiRrZXkiLCJ0ZW1wL2ZpbGUvc3RvcmUvMTY3MjM2OTcyOTYwNi82OTk1MjU5NzM2MzQyNjY4NDA0L2ltYWdlLnBuZyJdLFsiaW4iLCIkY29udGVudC10eXBlIixbImltYWdlL3BuZyJdXSxbImVxIiwiJGNhbGxCYWNrIiwiZXlKallXeHNZbUZqYTBKdlpIa2lPaUppZFdOclpYUTlKSHRpZFdOclpYUjlKbTlpYW1WamREMGtlMjlpYW1WamRIMG1iV2x0WlZSNWNHVTlKSHR0YVcxbFZIbHdaWDBtYzJsNlpUMGtlM05wZW1WOUptTnZiblJsYm5SVWVYQmxWSGx3WlQwa2UyTnZiblJsYm5SVWVYQmxWSGx3WlgwbVptOXliV0YwUFNSN2FXMWhaMlZKYm1adkxtWnZjbTFoZEgwbVltbDZkSGx3WlQxY0ltOXdaVzVoY0dsVGRHRnphRU5vWVc1blpVeHBibXRjSWlJc0ltTmhiR3hpWVdOclFtOWtlVlI1Y0dVaU9pSmhjSEJzYVdOaGRHbHZiaTlxYzI5dUlpd2lZMkZzYkdKaFkydFZjbXdpT2lKb2RIUndjem92TDJGd2FTMXZjM051YjNScFpua3RjMmN0Y0hKbGRtbGxkeTV0ZVhOb2IzQnNhVzVsTG1OdmJTOWhjR2t2YzJsbmJtRjBkWEpsTDI5emN5OXdiM04wTDI1dmRHbG1lU0o5Q2c9PSJdLFsiaW4iLCIkeC1vc3MtY29udGVudC10eXBlIixbImZvcm0tZmllbGQtbnVsbCJdXV19Cg==",
      "signature": "yOdrzcc5TybeOmasArln98Z/Fi4=",
      "url": "https://sl-resource-tmp-sg.s3-ap-southeast-1.xxx.com/temp%2Ffile%2Fstore%2F1672369729606%2F6995259736342668404%2Fimage.png?Expires=1747882880&OSSAccessKeyId=LTAI5tNjm7fr4EUCoEps4UPE&Signature=kLIWPCVwWTQMZcHUWyszjoH4DPM%3D"
    }
  ]
}

这篇文章对你有帮助吗？

SHOPLINE

条款协议