Skip to content

Reprocessa um vídeo cuja conversão falhou

POST/api/media/{id}/reprocess

Auth
Requires a token
Who can call it:
owner
admin
moderator
finance
SuperAdmin
X-CommunityId
X-CommunityId Send the X-CommunityId of the community the operation happens in.
Endpoint descriptions come straight from the API specification and are in Portuguese for now. The interface around them is translated.

Só a equipe da comunidade dona do vídeo (owner, admin, moderador, financeiro) e o SuperAdmin. O vídeo precisa estar com `processingStatus: failed`; ele volta para a fila de conversão adaptativa (HLS), a mesma dos envios novos, e a resposta é imediata (202). Não há webhook: acompanhe por `GET /api/media/{id}` até `processingStatus` virar `ready` (ou `failed` de novo). Até lá o MP4 original segue tocando. Limite de 20 pedidos por hora por perfil (429). 409 se o vídeo não está em `failed` ou se o streaming nativo está desligado na comunidade (a conversão custa; a mesma regra de `convert`); 503 se a conversão não está disponível neste ambiente.

Parameters

NameInTypeDescription
idrequiredpathstring (uuid)

Headers

NameTypeDescription
X-CommunityIdoptionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Request body application/json

The specification does not declare the fields of this body (a multipart upload, for example). See the topic guide.

Responses

StatusDescription
202Vídeo na fila.
401Token ausente, inválido ou expirado.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
409O vídeo não está com a conversão falha.
429Limite de pedidos por hora.
500Erro interno do servidor.
503Conversão indisponível neste ambiente.

curl example

curl -X POST "https://api.memberfy.net/api/media/<id>/reprocess" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{}'