Cria um membro na comunidade
POST/api/members
- Auth
- Requiere token
- Quién puede:
- owner
- admin
- X-CommunityId
X-CommunityIdEnví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.
Owner e admin da comunidade do `X-CommunityId` podem dar qualquer papel atribuível, admin inclusive (a mesma regra da promoção). Owner nunca é dado na entrada; moderator e abaixo recebem 403. A pessoa recebe pela fila (a resposta não espera o envio) o link de uso único `https://<app da comunidade>/_/auth/set-password?id=&token=`, válido por 7 dias (ver `POST /api/auth/set-password`). A resposta não traz mais `tempPassword`. **Comunidade suspensa pela Memberfy**: 403 com `errors`, `code: COMMUNITY_SUSPENDED` e o motivo (em `message` e em `reason`) para owner, admin, moderador e financeiro; nada é criado nem enviado.
Headers
| Nombre | Tipo | Descripción |
|---|---|---|
X-CommunityIdopcional | string (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
| Nombre | Tipo | Descripción |
|---|---|---|
fullNameobligatorio | string | Full name must be between 2 and 100 characters · min 2, max 100 |
emailobligatorio | string (email) | Valid email is required |
roleobligatorio | admin | moderator | member | finance | Valid role is required |
avatarUrlopcional | string (uri) | Avatar URL must be a valid URL |
jobTitleopcional | string | Cargo da pessoa nesta comunidade (opcional, até 100 caracteres; vazio vira `null`). · max 100 |
titleopcional | string | Sinônimo de `jobTitle`, aceito por compatibilidade. Se os dois vierem, vale `jobTitle`. · max 100 |
Respuestas
| Código | Descripción |
|---|---|
201 | Operação realizada com sucesso. |
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 anterior à F-31 F3 ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`). |
409 | O e-mail pediu para não participar da comunidade (recusou um convite); nada é criado nem enviado. |
500 | Erro interno do servidor. |
Ejemplo con curl
curl -X POST "https://api.memberfy.net/api/members" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{"fullName":"string","email":"[email protected]","role":"admin"}'