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.
Paramètres
upload_idstringID of the media-library upload session.
Contenu de la réponse
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.
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.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet.