Movies

Start uploading a movie's file

POST/movies/{id}/upload-ticket/

write Change: creates or edits. Scopes

Prepares an upload from your computer straight to a server that keeps movies and episodes, from the same address that asked. Send the file to upload_url in PUT requests of at most chunk_size bytes, each with a Content-Range header; a HEAD answers how much has arrived (X-Vod-Offset).

Path parameters

  • idstring (uuid)required

    The movie's id.

Body

  • serverstring (uuid)required

    A server that keeps movies and episodes.

  • filenamestringrequired
  • size_bytesintegerrequired

Response

200 OK

  • job_idstring (uuid)required

    The transfer, as GET /vod/jobs/ lists it.

  • upload_urlstring (uri)required

    The server's address to send the file to.

  • chunk_sizeintegerrequired

    The most bytes one PUT may carry.

  • expires_inintegerrequired

    Seconds the address works for.

Errors

  • 400 Something sent is not valid. Each field that is wrong is named with what is wrong.
  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 404 Nothing with this id, or nothing the account can see.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means