Skip to main content
The videos/ endpoint provides an interface for managing videos in the shop system. Videos can be uploaded and the corresponding URLs can be queried via the API. Various video formats are supported, as well as individual restrictions such as maximum file size and allowed formats, which are controlled via the shop configuration content.videoSettings.

​
Supported methods

List of all supported methods.
Command/InfoEndpointsGETPUTPOSTDELETE
Video URL
Video upload

​
General

  • Supported video formats:
    • mp4
    • avi
    • mov
    • wmv
    • flv
    • mkv
    • webm
    • mpeg
    • 3gp
    • ogg/ogv
  • Maximum file size
    Defined via the configuration content.videoSettings.
  • Allowed formats
    The permitted video formats can also be configured via content.videoSettings.

​
Methods for video upload

​
GET videos/url/{typeId}

This endpoint returns the URL where videos of the specified type (e.g. category or product videos) are stored. The path parameter typeId must have the value categories or products.

​
Example

http://www.<your-shop>.de/admin/api/v1/videos/url/categories

​
Response

{
    "url": "//content.myshop.localhost/categories/video"
}

​
Error codes

ErrorTypeReason
401 UnauthorizedNot authorized: you are not logged in or you do not have the required permissions to read category or product data.
400 Bad Request”invalidValue”
400 Bad Request”missing”subshopId was not provided.

​
POST videos/upload/{typeId}

This endpoint allows uploading a video for a specified type (e.g. categories or products). The path parameter typeId must have the value categories or products. The request body must contain the file name (fileName) and the binary data of the video (videoData). After a successful upload, the name of the uploaded file is returned. Write permissions for category or product data are required.

​
Example

http://www.<your-shop>.de/admin/api/v1/videos/upload/categories?subshopId=deutsch

​
Request body

Content-Type: multipart/form-data

fileName: myVideo.mp4
videoData: <binary data of the video file>

​
Response

{
    "newFile": "myVideo.mp4"
}

​
Error codes

ErrorTypeReason
401 UnauthorizedNot authorized: you are not logged in or you do not have the required permissions to write category or product data.
400 Bad Request”missing”subshopId was not provided.
video was not provided (if fileName or videoData are missing or empty).
400 Bad Request”invalidValue”
400 Bad Request”invalidFileFormat”The video has an invalid format.
503 Service Unavailable”internalError”The upload failed.

​
Support

Bei technischen Fragen und Hilfestellungen ist unser Support-Team für Sie erreichbar: Zum Kundenportal Bitte senden Sie uns eine möglichst detaillierte Beschreibung sowie Screenshots, Requests/Antworten, damit wir Ihre Anfrage zeitnah und zielführend beantworten können.