Confirma o envio e liga o arquivo ao item
POST/api/downloads/items/{id}/files/confirm
- Auth
- Requiere token
- X-CommunityId
X-CommunityIdEnví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.
O autor do item e a equipe. Depois do `PUT` direto ao S3, a API confere o objeto (existe, tamanho declarado, tipo da lista e **primeiros bytes combinando com o formato**: um executável renomeado `.pdf` é recusado e o objeto 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). No modo `single` o item aceita um arquivo só: um segundo é 409 (use `replace`).
A resposta traz o `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. O armazenamento de Downloads soma ao de Cursos nos mesmos limites.
Parámetros
| Nombre | Dónde | Tipo | Descripción |
|---|---|---|---|
idobligatorio | path | string (uuid) |
Headers
| Nombre | Tipo | Descripción |
|---|---|---|
X-CommunityIdopcional | string (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
| Nombre | Tipo | Descripción |
|---|---|---|
keyobligatorio | string | A `key` de /files/upload-url. |
nameobligatorio | string | max 255 |
sizeopcional | integer | Opcional: se vier e diferir do objeto, 400. |
Respuestas
| Código | Descripción |
|---|---|
200 | Arquivo ligado ao item. |
400 | Requisição inválida — falha de validação. |
401 | Token ausente, inválido ou expirado. |
403 | Autenticado, mas sem permissão para esta operação. |
404 | Recurso não encontrado. |
409 | Modo `single` já tem arquivo, ou o arquivo mudou durante a confirmação. |
500 | Erro interno do servidor. |
Ejemplo con curl
curl -X POST "https://api.memberfy.net/api/downloads/items/<id>/files/confirm" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{"key":"string","name":"string"}'