Busca de anfitrião pelo início do nome ou de qualquer palavra dele (público, com token)
GET/api/attendance/kiosk/hosts
- Auth
- Requiere token
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.
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.
Parámetros
| Nombre | Dónde | Tipo | Descripción |
|---|---|---|---|
qobligatorio | query | string |
Headers
| Nombre | Tipo | Descripción |
|---|---|---|
X-Kiosk-Tokenobligatorio | string | Token do quiosque. A comunidade e o space saem dele; nunca vão no corpo nem no caminho. |
Respuestas
| Código | Descripción |
|---|---|
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. |
Ejemplo con curl
curl -X GET "https://api.memberfy.net/api/attendance/kiosk/hosts" \
-H "Authorization: Bearer $TOKEN"