Pular para o conteúdo principal

Sandbox para envio de Vídeos de Produtos

Esta API permite a simulação, para uso dos desenvolvedores, do envio de vídeos específicos para um produto (SKU) em seu portfólio.

Convenções para Simulação​

  • Endpoints: Estes endpoints tem a mesma lógica dos que são direcionados para envio de vídeos em ambiente de produção e disponíveis no link: Produtos > Vídeos.
  • Headers obrigatórios:
    • x-tenant-id: Identificador do tenant (obrigatório).
    • x-sandbox-request: Deve ser igual a true para indicar que a requisição é destinada ao ambiente de sandbox.
  • Body request:
    • title: A validação do vídeo mockado no ambiente de Sandbox, será feita a partir do title do vídeo enviado no body da requisição.

Para criar um vídeo, 3 etapas precisam ser seguidas:​

1. Iniciar processo de upload de vídeo

Exemplo de chamada:
curl request POST \
  --url https://api-sandbox.magalu.com/seller/v1/portfolios/medias/{sku}/videos \
  --header 'Authorization: Bearer {{token}}' \
  --header 'Content-Type: application/json' \
  --header 'X-Tenant-Id: GENPUB.SeuTenant' \
  --header 'x-sandbox-request: true' \
  --data '{
  "file_type": "MP4",
  "title": "Tênis Nike Air Max 1"
}'
Exemplo de resposta esperada:

{
  "id": "a3429dab-59a4-4d43-bf18-0393722ea818",
  "sku": "sku123",
  "title": "Tênis Nike Air Max 1",
  "upload_url": "<SIGNED_URL_HERE>",
  "video_uuid": "a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6"
}

2. Fazer um PUT em uma URL assinada que é retornada pelo POST anterior

Exemplo de chamada:
curl request PUT \
  --url https://storage.com/upload/signed-url-here \
  --header 'Content-Type: video/mp4' \
  --upload-file '/Downloads/Tênis Nike Air Max 1.mp4'

3. Fazer um post pra mais um endpoint de confirmação de upload

Exemplo de chamada:
curl request POST \
  --url https://api.magalu.com/seller/v1/portfolios/videos/{id}/confirm-upload \
  --header 'Authorization: Bearer {{token}}' \
  --header 'Content-Type: application/json' \
  --header 'X-Tenant-Id: GENPUB.SeuTenant' \
  --header 'x-sandbox-request: true'
Regra de validação do status do vídeo no Sandbox:
  • Se o campo title do vídeo começar com erro_1, o status retornado será Not approved.
  • Se o campo title começar com erro_2, o status retornado será Pending adjustments.
  • Para qualquer outro valor de title, o status retornado será Approved. Use o campo title conforme necessário para simular diferentes cenários de resposta no ambiente Sandbox.