This endpoint enables you to upload a video file directly from your local device to FastPix for processing, storage. When you invoke this API with your preferred media settings, the response returns an uploadId and a pre-signed URL, providing a streamlined experience for uploading.
How it works
-
Send a POST request to the /on-demand/uploads endpoint with optional media settings.
-
The response includes an uploadId and a pre-signed URL for direct video file upload.
-
Upload your video file to the provided URL by making PUT request. The API accepts the media file from the device and uploads it to the FastPix platform.
-
Once uploaded, the media undergoes processing and is assigned a unique ID for tracking. Retain this uploadId for any future operations related to this upload.
After uploading, you can use the Get Media by ID endpoint to check the status of the uploaded media asset and see if it has transitioned to a "ready" status for playback.
To notify your application about the status of this API request check for the webhooks for Upload related events.
Use case scenario
Use case: A social media platform allows users to upload video content directly from their phones or computers. This endpoint facilitates the upload process. For example, if you are developing a video-sharing app where users can upload short clips from their mobile devices, this endpoint enables them to select a video, upload it to the platform.