Busca de anfitrião pelo início do nome ou de qualquer palavra dele (público, com token)
GET/api/attendance/kiosk/hosts
- Auth
- Jeton requis
- Clé d’API:
- attendance:read
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.
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.
Paramètres
| Nom | Emplacement | Type | Description |
|---|---|---|---|
qobligatoire | query | string |
En-têtes
| Nom | Type | Description |
|---|---|---|
X-Kiosk-Tokenobligatoire | string | Token do quiosque. A comunidade e o space saem dele; nunca vão no corpo nem no caminho. |
Réponses
| Statut | Description |
|---|---|
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. |
Exemple curl
curl -X GET "https://api.memberfy.net/api/attendance/kiosk/hosts" \
-H "Authorization: Bearer $TOKEN"