Upload a Pack asset.

Request a signed s3 URL to upload your Pack asset.

curl --location --request POST 'http://dev-cn.your-api-server.com/packs/123/uploadAsset' \ --header 'Content-Type: application/json' \ --data-raw '{ "packAssetType": "logo", "imageHash": "f0e4c2f76c58916ec258f246851bea091d14d4247a2fc3e18694461b1816e13b", "mimeType": "image/jpeg", "filename": "image.jpg" }'

{ "uploadUrl": "https://coda-us-west-2-prod-blobs-upload.s3-accelerate.amazonaws.com/packs/123/assets/logo/e23fcb5e564f08b71183d424c2c380c0", "packAssetUploadedPathName": "/packs/123/assets/e23fcb5e564f08b71183d424c2c380c0", "headers": "{\"header1\": \"value1\"}" }

请求参数

Path 参数

packId

integer

必需

ID of a Pack

>= 1

示例值:

123

Body 参数application/json

Payload for a Pack asset upload.

packAssetType

enum<string>

必需

枚举值:

logocoverexampleImage

imageHash

string

必需

The SHA-256 hash of the image to be uploaded.

示例值:

f0e4c2f76c58916ec258f246851bea091d14d4247a2fc3e18694461b1816e13b

mimeType

string

必需

The media type of the image being sent.

示例值:

image/jpeg

filename

string

必需

示例值:

image.jpg

示例

返回响应

🟢200The information indicating where to upload the Pack asset.

application/json

Body

Information indicating where to upload the Pack asset, and an endpoint to mark the upload as complete.

uploadUrl

string <url>

必需

A signed URL to be used for uploading a Pack asset.

示例值:

https://coda-us-west-2-prod-blobs-upload.s3-accelerate.amazonaws.com/packs/123/assets/logo/e23fcb5e564f08b71183d424c2c380c0

packAssetUploadedPathName

string

必需

An endpoint to mark the upload as complete.

示例值:

/packs/123/assets/e23fcb5e564f08b71183d424c2c380c0

headers

object

必需

Key-value pairs of authorization headers to include in the upload request.

示例值:

{"header1": "value1"}

额外字段

string

可选

🟠400400

🟠401401

🟠403403

🟠404404

🟠429429