Troca o arquivo por um novo envio
POST/api/downloads/items/{id}/files/{fileId}/replace
- Auth
- Exige token
- X-CommunityId
X-CommunityIdEnvie o X-CommunityId da comunidade em que a operação acontece.
Mesmo corpo e mesmas checagens de `/files/confirm`, mas o envio entra no lugar do arquivo `fileId` (mantém a posição e a contagem de downloads). O objeto anterior é apagado e o armazenamento ajustado; o volume do mês soma o novo envio. Vale para os próximos downloads. Pede-se a URL de envio por `/files/upload-url` como no envio comum.
Parâmetros
| Nome | Onde | Tipo | Descrição |
|---|---|---|---|
idobrigatório | path | string (uuid) | |
fileIdobrigatório | path | string (uuid) |
Headers
| Nome | Tipo | Descrição |
|---|---|---|
X-CommunityIdopcional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Corpo da requisição application/json
| Nome | Tipo | Descrição |
|---|---|---|
keyobrigatório | string | |
nameobrigatório | string | |
sizeopcional | integer |
Respostas
| Código | Descrição |
|---|---|
200 | Arquivo trocado (mesmo formato do confirm). |
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 | O arquivo mudou durante a troca. |
500 | Erro interno do servidor. |
Exemplo com curl
curl -X POST "https://api.memberfy.net/api/downloads/items/<id>/files/<fileId>/replace" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{"key":"string","name":"string"}'