Vai al contenuto

Convidado esperado hoje, pelo nome digitado (público, com token)

GET/api/attendance/kiosk/expected

Auth
Richiede un token
Le descrizioni degli endpoint provengono dalla specifica dell’API e per ora sono in portoghese. L’interfaccia intorno è tradotta.

Para a tela "Você é Maria S.?" (F-83). Só procura com **duas ou mais palavras, ao menos duas delas com 3 letras ou mais** (casa por início de palavra, sem acento nem caixa: "Mar Sou" acha "Maria de Souza"); com menos que isso a tela nem deve chamar. Devolve **no máximo 3** itens `{ expectedId, shortName }` (nome abreviado), só de convidados **esperados hoje** (dia da comunidade), **ainda não chegados** e do space Presença deste quiosque. Nunca anfitrião, empresa, e-mail, telefone, janela nem a lista do dia. **Responde sempre 200**: sem texto suficiente, sem correspondência ou acima do limite devolve `expected: []`, no mesmo tempo (mínimo de 150 ms), sem pista de que há limite. Orçamento próprio de 10 por minuto por token e 300 textos distintos por hora por token, além do limite por IP (esse sim responde 429). O texto digitado não é registrado em log.

Parametri

NomeDoveTipoDescrizione
qfacoltativoquerystring

Header

NomeTipoDescrizione
X-Kiosk-TokenobbligatoriostringToken do quiosque. A comunidade e o space saem dele; nunca vão no corpo nem no caminho.

Risposte

CodiceDescrizione
200Até 3 convidados esperados (ou lista vazia).
401Token ausente, inválido ou revogado, ou space apagado.
403Autenticado, mas sem permissão para esta operação.
429Limite de taxa (por token e por IP). Traz `Retry-After` (segundos) e `errors`.
500Erro interno do servidor.

Esempio con curl

curl -X GET "https://api.memberfy.net/api/attendance/kiosk/expected" \
  -H "Authorization: Bearer $TOKEN"