Busca de anfitrião pelo início do nome ou de qualquer palavra dele (público, com token)
GET/api/attendance/kiosk/hosts
- Auth
- Richiede un token
Le descrizioni degli endpoint provengono dalla specifica dell’API e per ora sono in portoghese. L’interfaccia intorno è tradotta.
Procura residentes pelo **início do nome de exibição ou de qualquer palavra dele** ("Prado" acha "Ana Prado"), com pelo menos 3 letras (curingas `%` e `_` não contam) (menos: 400 com `errors`). No máximo 8 resultados, em ordem estável (nome, depois id), só quem tem acesso ao space e não foi removido. Devolve apenas `id`, `displayName`, `avatarUrl` e `initials`: nunca e-mail, telefone, papel ou plano. Limite: 30 por minuto e 300 por dia por token.
Parametri
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
qobbligatorio | query | string |
Header
| Nome | Tipo | Descrizione |
|---|---|---|
X-Kiosk-Tokenobbligatorio | string | Token do quiosque. A comunidade e o space saem dele; nunca vão no corpo nem no caminho. |
Risposte
| Codice | Descrizione |
|---|---|
200 | Até 8 anfitriões. |
400 | Requisição inválida — falha de validação. |
401 | Token ausente, inválido ou revogado, ou space apagado. |
403 | Autenticado, mas sem permissão para esta operação. |
429 | Limite de taxa (por token e por IP). Traz `Retry-After` (segundos) e `errors`. |
500 | Erro interno do servidor. |
Esempio con curl
curl -X GET "https://api.memberfy.net/api/attendance/kiosk/hosts" \
-H "Authorization: Bearer $TOKEN"