Refresh a media-library upload instruction
/v1/asset-upload-sessions/{upload_id}/prepareconst upload = await bird.assets.uploads.prepare("aus_01krdgeqcxet5s7t44vh8rt9mg");
console.log(upload.state);upload = client.assets.uploads.prepare("aus_01krdgeqcxet5s7t44vh8rt9mg")
print(upload.state)upload, err := client.Assets.Uploads.Prepare(context.Background(), "aus_01krdgeqcxet5s7t44vh8rt9mg")
if err != nil {
log.Fatal(err)
}
fmt.Println(upload.State)$upload = $bird->assets->uploads->prepare('aus_01krdgeqcxet5s7t44vh8rt9mg');
echo $upload->getState();bird assets uploads prepare <upload-id>curl -X POST "https://us1.platform.bird.com/v1/asset-upload-sessions/{upload_id}/prepare" \
-H "Authorization: Bearer $TOKEN"{
"id": "aus_01krdgeqcxet5s7t44vh8rt9mg",
"state": "pending",
"folder_id": "asf_01krdgeqcxet5s7t44vh8rt9mg",
"file": {
"filename": "invoice.pdf",
"content_type": "application/pdf",
"size_bytes": 1024,
"sha256": "4e2090a479f7ce6b17ad31f991988f12571bcafbd4a441cc4063644fc1400ae0"
},
"result": {
"asset_id": "ast_01krdgeqcxet5s7t44vh8rt9mg"
},
"next": [
{
"kind": "operation"
}
]
}
Refreshes the temporary upload instruction for a pending session. File properties and the one-hour session deadline remain unchanged. No replacement file or metadata is accepted.
Parameter
upload_idstringID of the media-library upload session.
Antwort-Payload
idstateThe session is awaiting transfer and completion.
Value: pending
expires_atAbsolute session expiry. Completion must finish before this deadline; starting it or refreshing an upload instruction does not extend it.
nameFrozen display name for a newly published asset.
alt_textFrozen alternative text, or null when omitted.
folder_idFrozen destination folder, or null for the library root.
fileExact properties of the original file. Calculate size and SHA-256 from its bytes before creating a session. Images allow up to 5,242,880 bytes; other supported media allow up to 25,000,000 bytes.
resultSaved publication receipt, or null until completed.
last_errorLast completion error, or null when no failure is recorded.
nextAvailable next steps for this session.
uploadSend the original file bytes to this URL with the exact headers and content length. Send no Bird credentials or cookies. Keep the URL private and call complete after the PUT succeeds.
Untergeordnete Attribute anzeigen
upload.methodHTTP method for transferring the file.
Value: PUT
upload.urlTemporary HTTPS upload URL. It can be reused for the same fixed file until expiry.
upload.required_headersHeaders the upload request must send exactly as provided.
upload.content_lengthRequired HTTP content length in bytes.
upload.expires_atUpload instruction expiry, bounded by the session and signing credentials.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.