Skip to content

Confirma o envio e cria a mídia

POST/api/media/confirm

Auth
Requires a token
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.

Depois do `PUT` direto ao S3, a API confere o objeto (existe, tamanho declarado, tipo e extensão da lista e **primeiros bytes combinando com o formato**; objeto recusado é apagado), **copia para uma chave final que o cliente nunca viu** e apaga a de envio (a URL pré-assinada não alcança mais o arquivo confirmado, SEC-76), gera a miniatura das imagens e cria o `MediaAsset`. Quem confirma é quem enviou. Use o `id` devolvido no corpo do dono: `videoMediaId` do post, `recordingMediaId` do evento (`PUT /api/events/{id}/recording`), `mediaId` da imagem da galeria ou do anúncio.

A resposta traz `usage` da comunidade e `warning` (`nearLimit` a partir de 80% de um limite, `overLimit` acima de 100%): passar do limite **não recusa** o envio. Envios que ninguém confirmar em 24 horas são apagados.

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

NameTypeDescription
keyrequiredstring
namerequiredstringmax 255
spaceIdrequiredstring (uuid)
sizeoptionalintegerOpcional: se vier e diferir do objeto, 400.

Responses

StatusDescription
200Mídia criada.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
429Mais de 60 confirmações por hora para este perfil.
500Erro interno do servidor.

curl example

curl -X POST "https://api.memberfy.net/api/media/confirm" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{"key":"string","name":"string","spaceId":"00000000-0000-0000-0000-000000000000"}'