Criar um tipo de sessão
POST/api/networking/session-types
- Auth
- Jeton requis
- Clé d’API:
- networking:write
- X-CommunityId
X-CommunityIdEnvoyez 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 está no programa do lado anfitrião (pendente, ativo ou pausado) cria os seus; owner/admin criam para alguém com `memberId`. `durationMinutes` precisa ser uma das `durations` do espaço; até 20 por pessoa. Só `ONE_ON_ONE` por enquanto. Quem não é anfitrião: 403 `notHost`.
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) | |
memberIdfacultatif | string (uuid) | |
titleobligatoire | string | max 120 |
descriptionfacultatif | string | max 2000 |
durationMinutesobligatoire | integer | |
requiresApprovalfacultatif | boolean | |
activefacultatif | boolean | |
sortOrderfacultatif | integer | ≥ 0, ≤ 1000 |
Réponses
| Statut | Description |
|---|---|
201 | Criado. |
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. |
422 | Regra do programa (limite, antecedência, horizonte, duração) ou valor que não serve. |
500 | Erro interno do servidor. |
Exemple curl
curl -X POST "https://api.memberfy.net/api/networking/session-types" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{"spaceId":"00000000-0000-0000-0000-000000000000","title":"string","durationMinutes":1}'