Cria imagens da galeria a partir de mídias enviadas (F-76)
POST/api/gallery/images
- Auth
- Exige token
- X-CommunityId
X-CommunityIdEnvie o X-CommunityId da comunidade em que a operação acontece.
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.
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 |
|---|---|---|
spaceIdobrigatório | string (uuid) | |
itemsobrigatório | object[] | |
items[].mediaIdobrigatório | string (uuid) | |
items[].titleopcional | string | max 200 |
items[].descriptionopcional | string | max 2000 |
items[].tagsopcional | string[] |
Respostas
| Código | Descrição |
|---|---|
201 | Imagens criadas. |
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 | A mídia já está ligada a outro dono. |
500 | Erro interno do servidor. |
Exemplo com 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":[{}]}'