Video Oluşturma / Listeleme Servisi

Entegrasyon servisleri aracılığıyla satıcıların/entegratörlerin ürünler için video içeriği oluşturması ve videoların alınması için bu servisi kullanabilirsiniz.

• Bir satıcı aynı productContentId için sadece 1 aktif (silinmemiş ve reddedilmemiş) video oluşturabilir.
• isApproved: true olana kadar video son kullanıcıya gösterilmez.
• Tüm config değerleri (dosya boyutu limiti, süre limitleri, timeout) dinamik olarak yönetilir ve değiştirilebilir.
• Video başarıyla indirilip (SUCCESS) optimize edildikten sonra otomatik olarak aynı productContentId'ye sahip eski videolardan bu ürün ilişkisi kaldırılır.

❗️

TOPLU İŞLEM KONTROLÜ

Video oluşturma işlemi sonrasında response içerisinde yer alan videoId ile videolarınızın işleminin durumunu Videoları Listeleme / Sorgulama servisi üzerinden kontrol etmeniz gerekmektedir.

1. POST Video Oluşturma

Video içeriği oluşturma işlemini başlatır. Video, verilen URL'den indirilir ve arka planda işlenir. 200 req/min rate limit belirlenmiştir.

Request Body

Geçerli videoContentType değerleri:

Örnek Servis İsteği - Video Oluşturma

{
    "title": "Ürün Tanıtım Videosu",
    "description": "Yeni sezon ürün tanıtımı",
    "videoUrl": "https://cdn.example.com/video.mp4",
    "productContentIds": ["123456", "789012"],
    "videoContentType": "PRODUCT_PROMOTION"
  }

Başarılı Response (200)

Video içeriği oluşturulur ve videoId döner. Videonun indirilmesi ve işlenmesi arka planda devam eder.

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

Hata Kodları

İstek validasyonlarından kaynaklanan hatalar. HTTP Status: 400

2. GET Videoları Listeleme / Sorgulama

Satıcının entegrasyon videolarını listeler. Opsiyonel filtrelerle belirli bir video ID veya status'e göre sorgulama yapılabilir. 1000 req/min rate limit belirlenmiştir.

Query Parametreleri

Geçerli sellerIntegrationStatus değerleri:

Örnek Servis Cevabı - Video Listeleme

{
  "meta": {
    "page": 0,
    "total": 2,
    "totalPage": 1,
    "size": 10
  },
  "data": [
    {
      "id": "627b8a1b-7bad-4eaf-9abb-99a9958540c2",
      "title": "Ürün Tanıtım Videosu",
      "description": "Yeni sezon ürün tanıtımı",
      "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": "Montaj Videosu",
      "description": "",
      "status": "FAILED",
      "videoUrl": "https://cdn.example.com/montaj.avi",
      "productContentIds": ["789012"],
      "errorCode": "video.content.api.seller.integration.video.format.invalid",
      "isApproved": false
    }
  ]
}

Response Alanları

status ve isApproved ilişkisi:

Video Dosyası Gereksinimleri

Video dosyası uzantısı ve içeriği (magic bytes) kontrol edilir. Uzantı .mp4 olan bir dosyanın gerçek içeriği de MP4 formatında olmalıdır.

Hata Kodları

Video indirme ve işleme sürecinde oluşan hatalar. errorCode alanında döner.