API ReferenceCommunities
POST /communities
Criar comunidade
POST
/communitiesAuth: accessTokenCria uma nova comunidade. O criador torna-se automaticamente owner.
Request
Body (JSON)
| Campo | Tipo | Descrição |
|---|---|---|
| name * | string | Nome da comunidade |
| description | string | Descrição da comunidade |
| isPrivate | boolean | Se a comunidade é privada (padrão: false) |
| tags | string[] | Tags para categorizar a comunidade |
Response
201
{
"id": "uuid",
"name": "string",
"description": "string | null",
"isPrivate": false,
"tags": ["string"],
"createdAt": "ISO 8601",
"ownerId": "uuid"
}Erros
| Código | Descrição |
|---|---|
| 401 | Não autenticado |
Exemplos
curl -X POST 'https://geeksocialapi.homelab-cloud.com/communities' \
-H 'Authorization: Bearer SEU_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"name":"Geeks do Brasil","isPrivate":false,"tags":["games","tech"]}'await fetch('https://geeksocialapi.homelab-cloud.com/communities', {
method: 'POST',
headers: { Authorization: 'Bearer ' + accessToken, 'Content-Type': 'application/json' },
body: JSON.stringify({"name":"Geeks do Brasil","isPrivate":false,"tags":["games","tech"]}),
})