Links Compartilháveis API

Esta endpoint permite gerar links públicos e seguros para seus ativos de mídia. Esses links podem ser protegidos por senha e ter uma data de expiração.

Gerar um Link Compartilhável

POST /links-compartilháveis

Essa endpoint cria um link único para um vídeo (VOD), um transmissão ao vivo ou uma coleção de vídeos.

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
`media_id`	`string`	Sim	O ID único do ativo. Isso é um UUID para vídeos.
`media_type`	`string`	Sim	O tipo de ativo. Deve ser um dos seguintes: `vod`, `live`, `collection`.
`visibility`	`string`	Sim	Nível de acesso. Deve ser um dos seguintes: `public`, `password`.
`password`	`string`	Opcional	Requerido se `visibility` for `password`. Mínimo 6 caracteres.
`expires_in_days`	`integer`	Opcional	O número de dias até o link automaticamente expirar. Max 365.

Exemplos de Requisições

Para um Vídeo (VOD)


{
    "media_id": "9c1a9e3e-6c9b-4f8a-8e2d-9b3c1d4e0f6a",
    "media_type": "vod",
    "visibility": "public",
    "expires_in_days": 7
}

Para uma Coleção


{
    "media_id": "42",
    "media_type": "collection",
    "visibility": "public"
}

Protegido por Senha


{
    "media_id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
    "media_type": "live",
    "visibility": "password",
    "password": "super-secret-password"
}

Exemplo de Resposta: 201 Created

Ao sucesso, a API retornará os detalhes do link gerado.


{
  "link": "https://sua-aplicação.com/s/aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoP",
  "token": "aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoP",
  "visibility": "public",
  "expires_at": "2025-08-17T14:30:00Z"
}