Aller au contenu
memberfy
FR

Entrar no programa ("Quero ser mentor", "Participar")

POST/api/networking/participants/me

Auth
Jeton requis
Qui peut l’appeler:
owner
admin
Clé d’API:
networking:write
X-CommunityId
X-CommunityId Envoyez le X-CommunityId de la communauté où l’opération a lieu.
Les descriptions des endpoints viennent directement de la spécification de l’API et sont en portugais pour l’instant. L’interface autour est traduite.

Quem chama entra no espaço de Networking. No modelo simétrico o lado é sempre `BOTH` ("Participar": oferece e marca); no de mentoria, `side` é `HOST` ou `PARTICIPANT`. A regra do lado decide: `OPEN` entra direto (`ACTIVE`, aparece no Explorar), `APPROVAL` fica `PENDING` e owner e admin recebem e-mail (categoria "Networking") e veem o contador; `INVITE` só a equipe adiciona (403). Owner e admin entram sempre direto. Ser anfitrião exige papel permitido por `offerers` (403) e, se o espaço tiver regra de anfitrião (`PUT /api/networking/host-rule`), casar com um dos grupos, tags ou badges (403 `hostNotEligible`). Já participando: 409; removido pela equipe: 403. Quem foi recusado pode pedir de novo. No modelo de mentoria, desde 2026-10-29, ninguém precisa entrar como `PARTICIPANT` para marcar: quem abre o espaço já é mentorado. `side: PARTICIPANT` continua aceito (para guardar `seeks` e categorias), mas é opcional; quem tem participação `PARTICIPANT` viva pode pedir `side: HOST` (a participação passa para o lado anfitrião, sem 409).

En-têtes

NomTypeDescription
X-CommunityIdfacultatifstring (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

NomTypeDescription
spaceIdobligatoirestring (uuid)
sidefacultatifHOST | PARTICIPANTObrigatório no modelo de mentoria; ignorado no simétrico.
offersfacultatifstringmax 1000
seeksfacultatifstringmax 1000
categoryKeysfacultatifstring[]

Réponses

StatutDescription
201Entrou (`ACTIVE`) ou pediu (`PENDING`).
400Requisição inválida — falha de validação.
401Token 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`).
403Autenticado, mas sem permissão para esta operação.
409Conflito com o estado atual do recurso.
500Erro interno do servidor.

Exemple curl

curl -X POST "https://api.memberfy.net/api/networking/participants/me" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{"spaceId":"00000000-0000-0000-0000-000000000000"}'