Skip to main content
Version: 1.2.0-1.3.0

Media file upload guidelines

You can upload media files (image or video) to be shown on the DOSI digital item page by using API. It can be done only after issuing an item type or sealing an online product.

When there is no media file for a certain digital item, the DOSI Brand Store displays the media file for the item type of the given digital item. Consequently, no image is displayed if you haven't uploaded any item type media file.

If you're using HTTP client library to upload media files, you must send it as multipart/form-data. It may be different for each library, but the general rule is to set Content-Type in the request header as "multipart/form-data".

Requirements

You need to comply with the following guidelines when uploading a media file.

  • Images
    • File type: JPG, PNG, GIF
    • File size: Up to 3 MB
    • Recommended resolution: 1300 x 1300 pixels
  • Videos
    • File type: MP4
    • File size: Up to 200 MB (Using a file smaller than 80 MB is recommended)
    • Recommended resolution: 960 x 960 pixels

Media file upload sequence

As mentioned earlier, you need to follow the next steps to upload media files.

Item type media file

  1. Issue an item type.
  2. Upload a media file for the issued item type with item type media file upload.

You must upload a media file for the item type to avoid showing a null image on the DOSI digital item page.

Digital item media file

  1. Seal an online product.
  2. Upload a media file for the sealed digital item with the Upload the media file for the digital item endpoint.

Replace media files

Of the digital items issued, you can replace the media file (images or videos) of digital items that are yet to be sealed or sold. The media file of digital items in a user's wallet, as they have been sealed and sold, are irreplaceable.