A equipe registra a chegada de um visitante
POST/api/attendance/spaces/{spaceId}/guest-check-in
- Auth
- Requires a token
- X-CommunityId
X-CommunityIdSend the X-CommunityId of the community the operation happens in.
Endpoint descriptions come straight from the API specification and are in Portuguese for now. The interface around them is translated.
Owner, admin, moderador e financeiro registram um **visitante** (sem conta) pela tela da equipe, com método `RECEPTION`. `guestName` e `hostProfileId` (membro da comunidade com acesso ao space) são obrigatórios; `guestCompany` e `guestPhone` seguem `kiosk.guestFields` do space. **Idempotente** por nome normalizado + anfitrião + space (`200` com `alreadyCheckedIn: true`; cria: `201`). Com `kiosk.notifyHost`, o anfitrião recebe o e-mail pela fila (teto de 10 por hora por anfitrião). O visitante conta na lotação e aparece em "Quem está aqui". Anfitrião sem acesso ao space: 403; de outra comunidade ou inexistente: 404.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
spaceIdrequired | path | string (uuid) |
Headers
| Name | Type | Description |
|---|---|---|
X-CommunityIdoptional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Request body application/json
| Name | Type | Description |
|---|---|---|
guestNamerequired | string | max 100 |
guestCompanyoptional | string | max 100 |
guestPhoneoptional | string | max 30 |
hostProfileIdrequired | string (uuid) |
Responses
| Status | Description |
|---|---|
200 | Já havia visita aberta deste visitante com este anfitrião. |
201 | Visita aberta. |
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. |
500 | Erro interno do servidor. |
curl example
curl -X POST "https://api.memberfy.net/api/attendance/spaces/<spaceId>/guest-check-in" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{"guestName":"Maria Souza","hostProfileId":"00000000-0000-0000-0000-000000000000"}'