Changing the Poster Image of Videos in Fastevo Media Protection Platform (MP2)
Fastevo Media Protection Platform (MP2) allows you to change the poster image of your video content. This guide will walk you through the process of uploading a custom poster image and setting an image from the Engage Kit as the poster.
Poster images enhance the visual representation of your video content, providing a more engaging user experience.
Uploading a Custom Poster Image
To upload a custom poster image, you must send a multipart/form-data request with the image file.
Endpoint
POST https://api.fastevo.net/api/v1/projects/mediaProtection/contents/{contentId}/poster/custom
Request
contentId: The ID of the media content to which you want to add a custom poster image.
Example Request
curl -X POST https://api.fastevo.net/api/v1/projects/mediaProtection/contents/{contentId}/poster/custom \
-H "Authorization: Bearer {projectApiKey}" \
-H "Content-Type: multipart/form-data" \
-F "file=@path_to_image_file.png"Ensure the image file is in a supported format (e.g., PNG, JPEG) and properly encoded. Note that this endpoint requires multipart/form-data instead of the usual application/json.
Setting an Engage Kit Image as Poster
To set an image from the Engage Kit as the poster, you need to perform a POST request to the following endpoint:
Endpoint
POST https://api.fastevo.net/api/v1/projects/mediaProtection/contents/{contentId}/poster/engageKit
Request
contentId: The ID of the media content you want to update.engageKitFileId: The ID of the Engage Kit file you want to set as the poster.
Example Request
curl -X POST https://api.fastevo.net/api/v1/projects/mediaProtection/contents/{contentId}/poster/engageKit \
-H "Authorization: Bearer {projectApiKey}" \
-H "Content-Type: application/json" \
-d '{"engageKitFileId": "fileIdFromEngageKit"}'API Response
After successfully setting the Engage Kit image as the poster, the API will return a response with a status code of 200 and a JSON body indicating success.
Example Success Response
{
"success": true
}Retrieving Content Information
To retrieve information about your content, including the Engage Kit file IDs, please refer to the Content Management documentation. This is especially useful as the Engage Kit file IDs can be retrieved from there.