Vai al contenuto

Lista os convidados

GET/api/visitors/spaces/{spaceId}/invitations

Auth
Richiede un token
X-CommunityId
X-CommunityId Invia l’X-CommunityId della community in cui avviene l’operazione.
Le descrizioni degli endpoint provengono dalla specifica dell’API e per ora sono in portoghese. L’interfaccia intorno è tradotta.

O membro vê **só os seus** (os que ele recebe ou cadastrou), em qualquer data. Moderador e financeiro veem também os esperados **de hoje** (todos os anfitriões). Owner e admin veem qualquer data. Ordem por horário esperado. `status` aceita `EXPECTED` (hoje em diante), `ARRIVED`, `CANCELED` e `NO_SHOW` (derivado: esperado de um dia que já passou). `from` e `to` são dias `AAAA-MM-DD` (inclusivos) no fuso da comunidade.

Parametri

NomeDoveTipoDescrizione
spaceIdobbligatoriopathstring (uuid)
statusfacoltativoqueryEXPECTED | ARRIVED | CANCELED | NO_SHOW
fromfacoltativoquerystringAAAA-MM-DD
tofacoltativoquerystringAAAA-MM-DD
qfacoltativoquerystringParte do nome ou da empresa.
hostProfileIdfacoltativoquerystring (uuid)Só os convidados deste anfitrião (vale dentro do que quem chama já pode ver; útil para owner e admin).
pagefacoltativoqueryinteger
limitfacoltativoqueryinteger

Header

NomeTipoDescrizione
X-CommunityIdfacoltativostring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Risposte

CodiceDescrizione
200Página de convidados.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
500Erro interno do servidor.

Esempio con curl

curl -X GET "https://api.memberfy.net/api/visitors/spaces/<spaceId>/invitations" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"