Check-in pelo quiosque do evento (público, com token)
POST/api/events/kiosk/check-in
- Auth
- Richiede un token
- Chiave API:
- events:write
Le descrizioni degli endpoint provengono dalla specifica dell’API e per ora sono in portoghese. L’interfaccia intorno è tradotta.
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.
Header
| Nome | Tipo | Descrizione |
|---|---|---|
X-Event-Kiosk-Tokenobbligatorio | string | Token do quiosque do evento. A comunidade e o evento saem dele. |
Corpo della richiesta application/json
| Nome | Tipo | Descrizione |
|---|---|---|
tokenobbligatorio | string | O conteúdo do QR do ingresso. |
Risposte
| Codice | Descrizione |
|---|---|
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. |
Esempio 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"}'