Cria imagens da galeria a partir de mídias enviadas
POST/api/gallery/images
- Auth
- Jeton requis
- Clé d’API:
- gallery:write
- X-CommunityId
X-CommunityIdEnvoyez le X-CommunityId de la communauté où l’opération a lieu.
Cria até 50 imagens num space `gallery` a partir de mídias confirmadas em `POST /api/media/confirm` (finalidade `galleryImage`, enviadas pelo próprio autor para esse space). **A imagem é privada**: a resposta traz `mediaId` (e `imageUrl` vazia) e quem lê pede os links assinados em `POST /api/media/urls` (inclui a miniatura). Respeita `canCreate` do space e a aprovação prévia (`moderationStatus`). Imagens enviadas antes por `POST /api/upload/gallery/images` seguem com a URL pública. Apagar a imagem (`DELETE /api/gallery/images/{imageId}`) apaga o arquivo.
Envio em massa: `POST /api/media/upload-urls` (até 50) → `PUT` de cada arquivo direto ao S3 → `POST /api/media/confirm-batch` → esta rota com os `mediaId`. A mídia pode ainda estar em processamento: a imagem nasce com `processingStatus` `queued`/`processing` e fica `ready` sozinha (ou `failed`). Esta resposta, a listagem e o detalhe trazem `processingStatus` (null para imagem antiga ou processada no envio); enquanto não for `ready`, `POST /api/media/urls` devolve `url: null`.
En-têtes
| Nom | Type | Description |
|---|---|---|
X-CommunityIdfacultatif | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Corps de la requête application/json
| Nom | Type | Description |
|---|---|---|
spaceIdobligatoire | string (uuid) | |
itemsobligatoire | object[] | |
items[].mediaIdobligatoire | string (uuid) | |
items[].titlefacultatif | string | Opcional. Sem título (omitido, `""` ou `null`), a imagem é gravada com título vazio `""`. · max 200 |
items[].descriptionfacultatif | string | max 2000 |
items[].tagsfacultatif | string[] |
Réponses
| Statut | Description |
|---|---|
201 | Imagens criadas. |
400 | Requisição inválida — falha de validação. |
401 | Token ausente, inválido ou expirado; token de outra comunidade (o `X-CommunityId` ou o `communityId` do corpo não é o do token); token antigo ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`). |
403 | Autenticado, mas sem permissão para esta operação. |
404 | Recurso não encontrado. |
409 | A mídia já está ligada a outro dono. |
500 | Erro interno do servidor. |
Exemple curl
curl -X POST "https://api.memberfy.net/api/gallery/images" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{"spaceId":"00000000-0000-0000-0000-000000000000","items":[{}]}'