Video Upload / Listing Services

You can use this service to create video content for products and retrieve videos through integration services for sellers/integrators.

• You need to send "storeFrontCode" as Header Parameter.
• A seller can create only 1 active (not deleted and not rejected) video for the same productContentId.
• The video will not be shown to the end user until isApproved: true.
• All config values (file size limit, duration limits, timeout) are dynamically managed and can be changed.
• After a video is successfully downloaded (SUCCESS) and optimized, the product association is automatically removed from older videos with the same productContentId.

❗️

BATCH OPERATION CHECK

After the video creation process, you need to check the status of your videos using the videoId in the response through the Video Listing / Query service.

1. POST Create Video

Initiates the video content creation process. The video is downloaded from the given URL and processed in the background. A rate limit of 200 req/min is set.

Request Body

Valid videoContentType values:

Example Request - Create Video

{
    "title": "Product Promotion Video",
    "description": "New season product promotion",
    "videoUrl": "https://cdn.example.com/video.mp4",
    "productContentIds": ["123456", "789012"],
    "videoContentType": "PRODUCT_PROMOTION"
  }

Successful Response (200)

The video content is created and a videoId is returned. The video download and processing continues in the background.

{
  "videoId": "627b8a1b-7bad-4eaf-9abb-99a9958540c2"
}

Error Codes

Errors caused by request validations. HTTP Status: 400

1. GET List / Query Videos

Lists the seller's integration videos. Specific video ID or status-based queries can be made with optional filters. A rate limit of 1000 req/min is set.

Query Parameters

Valid sellerIntegrationStatus values:

Example Response - List Videos

{
  "meta": {
    "page": 0,
    "total": 2,
    "totalPage": 1,
    "size": 10
  },
  "data": [
    {
      "id": "627b8a1b-7bad-4eaf-9abb-99a9958540c2",
      "title": "Product Promotion Video",
      "description": "New season product promotion",
      "status": "SUCCESS",
      "videoUrl": "https://cdn.example.com/video.mp4",
      "productContentIds": ["123456"],
      "optimizedVideoUrl": "https://video-content.dsmcdn.com/.../video_hd.mp4",
      "isApproved": true
    },
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Assembly Video",
      "description": "",
      "status": "FAILED",
      "videoUrl": "https://cdn.example.com/montaj.avi",
      "productContentIds": ["789012"],
      "errorCode": "video.content.api.seller.integration.video.format.invalid",
      "isApproved": false
    }
  ]
}

Response Fields

status and isApproved relationship:

Video File Requirements

The video file extension and content (magic bytes) are verified. A file with a .mp4 extension must also have actual content in MP4 format.

Error Codes

Errors that occur during the video download and processing. Returned in the errorCode field.