Busca de anfitrião pelo início do nome ou de qualquer palavra dele (público, com token)
GET/api/attendance/kiosk/hosts
- Auth
- Token erforderlich
Die Beschreibungen der Endpoints stammen aus der API-Spezifikation und sind vorerst auf Portugiesisch. Die Oberfläche drumherum ist übersetzt.
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.
Parameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
qPflicht | query | string |
Header
| Name | Typ | Beschreibung |
|---|---|---|
X-Kiosk-TokenPflicht | string | Token do quiosque. A comunidade e o space saem dele; nunca vão no corpo nem no caminho. |
Antworten
| Status | Beschreibung |
|---|---|
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. |
curl-Beispiel
curl -X GET "https://api.memberfy.net/api/attendance/kiosk/hosts" \
-H "Authorization: Bearer $TOKEN"