A equipe registra a chegada de um visitante
POST/api/attendance/spaces/{spaceId}/guest-check-in
- Auth
- Requiere token
- 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, 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.
Parámetros
| Nombre | Dónde | Tipo | Descripción |
|---|---|---|---|
spaceIdobligatorio | path | string (uuid) |
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 |
|---|---|---|
guestNameobligatorio | string | max 100 |
guestCompanyopcional | string | max 100 |
guestPhoneopcional | string | max 30 |
hostProfileIdobligatorio | string (uuid) |
Respuestas
| Código | Descripción |
|---|---|
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. |
Ejemplo con curl
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"}'