JMV Public API

Gera um token JWT usando apenas o UUID do plano (resource). Endpoint oficial — nenhuma credencial de usuário é necessária.

Body

Requisição

CopiarPOST /v2/authenticate
Content-Type: application/json

{
  "resource": "eeba7244-e850-4064-aa61-008718b6e4b0"
}

Resposta — 200 OK

Copiar{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Retorna a lista paginada de vídeos do plano com opções de filtro e ordenação.

Query Parameters

Retorna um vídeo individual formatado com o secret do plano para geração de URLs assinadas.

Path Parameters

Remove um vídeo do plano. A remoção é processada de forma assíncrona — o vídeo fica indisponível imediatamente, mas a exclusão física do arquivo pode levar alguns instantes para ser concluída.

Move um vídeo para uma galeria diferente.

Body

Atualiza o nome de exibição de um vídeo.

Body

Faz upload de thumbnail via multipart/form-data. Limite de 1 MB. A imagem é enviada para a Static API e o campo thumb do vídeo é atualizado.

Retorna a lista de vídeos com jobs de conversão em andamento para o plano especificado.

Retorna o status normalizado do job de conversão de um vídeo.

Valores de retorno

Retorna a árvore de galerias do plano, incluindo galerias filhas (children).

Copiar{
  "folders": [
    {
      "id":          1,
      "uuid":        "a1b2c3d4-...",
      "name":        "Treinamentos",
      "description": "Vídeos de treinamento interno",
      "children": []
    }
  ]
}

Body

Atualiza nome e/ou descrição de uma galeria existente.

Remove uma galeria. Galerias com vídeos associados não podem ser removidas.

Cria um novo evento com status inicial WAITING_LIVE.

Body

Retorna lista paginada de eventos do plano.

Altera o status de um evento ao vivo. O ciclo de vida segue a sequência:

CopiarWAITING_LIVE  →  LIVE  →  ON_DEMAND

Remove um ou mais eventos. Aceita array de IDs no body.

Body

Copiar{
  "ids": [42, 43, 44]
}

Retorna todos os vídeos da playlist de um plano na ordem configurada.

Body

Altera a posição de um vídeo na playlist.

Body

Remove um vídeo da playlist sem excluí-lo do sistema.

Retorna o vídeo atualmente em reprodução no player. Consulta o banco de dados Webtv (leitura em tempo real).

Cria um novo target de stream no Stream Gateway.

Body

Retorna o status atual da transmissão diretamente do Stream Gateway.

Body

Remove a transmissão do Stream Gateway. Operação irreversível.

Cria um multipart upload no MinIO e retorna todas as presigned URLs de uma vez. Cada URL tem validade de 6 horas.

Body

Requisição

CopiarPOST /v2/upload/multipart/s3
Authorization: Bearer <token>
Content-Type: application/json

{
  "fileName":   "video-treinamento.mp4",
  "fileSize":   1073741824,
  "totalParts": 16,
  "chunkSize":  67108864
}

Resposta — 200 OK

Copiar{
  "uploadId":    "minio-upload-id-xyz",
  "objectName":  "uploads/vod123/a8f3k2m9x1q4p.mp4",
  "video_hash":  "a8f3k2m9x1q4p",
  "totalParts":  16,
  "presignedUrls": [
    { "partNumber": 1, "url": "https://minio.../upload?partNumber=1&uploadId=..." },
    { "partNumber": 2, "url": "https://minio.../upload?partNumber=2&uploadId=..." }
  ]
}

Envio das partes (client-side)

Para cada presigned URL, faça um PUT diretamente no MinIO com o chunk correspondente:

Copiar// JavaScript — enviar cada parte
const uploadedParts = [];

for (let i = 0; i < presignedUrls.length; i++) {
  const { partNumber, url } = presignedUrls[i];
  const start = i * chunkSize;
  const chunk = file.slice(start, start + chunkSize);

  const res = await fetch(url, {
    method: 'PUT',
    body: chunk,
    headers: { 'Content-Type': 'application/octet-stream' }
  });

  uploadedParts.push({
    partNumber,
    etag: res.headers.get('ETag')
  });
}

Finaliza o multipart upload no MinIO, registra o vídeo no banco e enfileira o job de processamento na fila s3-upload-queue.

Body

Requisição

Copiar{
  "filename":   "video-treinamento.mp4",
  "size":       1073741824,
  "video_hash": "a8f3k2m9x1q4p",
  "objectName": "uploads/vod123/a8f3k2m9x1q4p.mp4",
  "uploadId":   "minio-upload-id-xyz",
  "gallery":   "a1b2c3d4-e5f6-...",
  "parts": [
    { "partNumber": 1, "etag": "\"abc123\"" },
    { "partNumber": 2, "etag": "\"def456\"" }
  ]
}

Gera uma presigned URL para upload de arquivo em uma única requisição PUT. Validade de 24 horas. Recomendado para arquivos menores que 100 MB.

Body

Confirma que o arquivo foi enviado para o MinIO via PUT, valida a existência do objeto (headObject), registra o vídeo e enfileira o job de processamento.

Body