Check-in pelo quiosque do evento (público, com token)
POST/api/events/kiosk/check-in
- Auth
- Requiere token
- Clave de API:
- events:write
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.
O tablet lê o QR do ingresso e manda o conteúdo em `token`. Ingresso válido do evento do quiosque grava a presença com o método `kiosk` (`outcome: checked_in`); o mesmo ingresso de novo responde `already_checked_in` com o horário e não grava outra. Ingresso cancelado, de outro evento ou de outra comunidade: 404 "ingresso inválido", nada é gravado. Fora da janela ou com o check-in desligado: 409. O quiosque só lê QR: não aceita código nem busca por nome, e a resposta traz só o nome abreviado ("Maria S."), nunca o e-mail. Limite: 60 por minuto por token.
Headers
| Nombre | Tipo | Descripción |
|---|---|---|
X-Event-Kiosk-Tokenobligatorio | string | Token do quiosque do evento. A comunidade e o evento saem dele. |
Cuerpo de la solicitud application/json
| Nombre | Tipo | Descripción |
|---|---|---|
tokenobligatorio | string | O conteúdo do QR do ingresso. |
Respuestas
| Código | Descripción |
|---|---|
200 | `outcome` é `checked_in` (verde) ou `already_checked_in` (amarelo). |
400 | Requisição inválida — falha de validação. |
401 | Token ausente |
404 | Ingresso inválido (cancelado |
409 | Check-in desligado ou fora da janela. |
429 | Limite de taxa; traz `Retry-After`. |
500 | Erro interno do servidor. |
Ejemplo con curl
curl -X POST "https://api.memberfy.net/api/events/kiosk/check-in" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"token":"string"}'