Aller au contenu

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

POST/api/events/kiosk/check-in

Auth
Jeton requis
Clé d’API:
events:write
Les descriptions des endpoints viennent directement de la spécification de l’API et sont en portugais pour l’instant. L’interface autour est traduite.

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.

En-têtes

NomTypeDescription
X-Event-Kiosk-TokenobligatoirestringToken do quiosque do evento. A comunidade e o evento saem dele.

Corps de la requête application/json

NomTypeDescription
tokenobligatoirestringO conteúdo do QR do ingresso.

Réponses

StatutDescription
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.

Exemple 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"}'