Skip to content

Check-in pelo quiosque do evento (público, com token)

POST/api/events/kiosk/check-in

Auth
Requires a token
API key:
events:write
Endpoint descriptions come straight from the API specification and are in Portuguese for now. The interface around them is translated.

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

NameTypeDescription
X-Event-Kiosk-TokenrequiredstringToken do quiosque do evento. A comunidade e o evento saem dele.

Request body application/json

NameTypeDescription
tokenrequiredstringO conteúdo do QR do ingresso.

Responses

StatusDescription
200`outcome` é `checked_in` (verde) ou `already_checked_in` (amarelo).
400Requisição inválida — falha de validação.
401Token ausente
404Ingresso inválido (cancelado
409Check-in desligado ou fora da janela.
429Limite de taxa; traz `Retry-After`.
500Erro interno do servidor.

curl example

curl -X POST "https://api.memberfy.net/api/events/kiosk/check-in" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"token":"string"}'