Saltar al contenido

Atualiza a configuração do space de downloads

PUT/api/downloads/spaces/{spaceId}

Auth
Requiere token
Quién puede:
owner
admin
moderator
finance
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.

Somente owner e admin (moderador, financeiro e membro recebem 403). Todos os campos são opcionais. `mode`: `multi` (repositório, o padrão) ou `single` ("um arquivo só"); passar para `single` com 2 itens ou mais, ou com um item de 2 arquivos ou mais, é 409. `categories` é a lista completa e ordenada (item com `id` renomeia e reordena, sem `id` cria, o que não vem é removido; categoria com itens não sai: 400 dizendo quantos). `requireApproval` grava `Space.requireApproval` (itens de membro só publicam depois de aprovados na fila de moderação). Quem envia é `Space.canCreate`, que se muda na edição do space.

Parámetros

NombreDóndeTipoDescripción
spaceIdobligatoriopathstring (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
modeopcionalmulti | single
requireApprovalopcionalboolean
categoriesopcionalobject[]
categories[].idopcionalstring (uuid)
categories[].nameobligatoriostringmax 60

Respuestas

CódigoDescripción
200Configuração atualizada.
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.
409Modo `single` com itens ou arquivos demais.
500Erro interno do servidor.

Ejemplo con curl

curl -X PUT "https://api.memberfy.net/api/downloads/spaces/<spaceId>" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{}'