Saltar al contenido
memberfy
ES

Confirma o envio e liga o arquivo à aula

POST/api/courses/lesson/{lessonId}/media/confirm

Auth
Requiere token
Quién puede:
owner
admin
X-CommunityId
X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

Só owner e admin. Depois do `PUT` direto ao S3, a API confere o objeto (existe, o tamanho é o declarado, o tipo está na lista e os **primeiros bytes combinam com o formato**: um `.exe` renomeado para `.mp4` é recusado, e o objeto recusado é apagado) e só então grava `media` na aula e **limpa `contentUrl`** (URL externa e arquivo hospedado não coexistem). Se a aula já tinha arquivo, o anterior é apagado e o uso total ajustado; o volume do mês soma o novo envio. Confirmar duas vezes a mesma `key` não conta duas vezes.

A resposta traz o **uso** da comunidade e `warning` (`nearLimit` a partir de 80% de um limite, `overLimit` acima de 100%); passar do limite **não recusa** o envio. Sem limite definido, `warning` é `null`.

Parámetros

NombreDóndeTipoDescripción
lessonIdobligatoriopathstring (uuid)

Headers

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

Cuerpo de la solicitud application/json

NombreTipoDescripción
keyobligatoriostringA `key` devolvida por /media/upload-url.
nameobligatoriostringmax 255
sizeopcionalintegerOpcional: bytes declarados; se vier e diferir do objeto, 400.

Respuestas

CódigoDescripción
200Arquivo ligado à aula.
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.
409A mídia da aula mudou durante a confirmação; tente de novo.
500Erro interno do servidor.

Ejemplo con curl

curl -X POST "https://api.memberfy.net/api/courses/lesson/<lessonId>/media/confirm" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{"key":"string","name":"string"}'