Pular para o conteúdo

Qual recurso eu consigo?

GET/api/bookings/search

Auth
Exige token
X-CommunityId
X-CommunityId Envie o X-CommunityId da comunidade em que a operação acontece.

Busca por horário exato (`startsAt`) ou janela do dia (`date` + `from`/`to`), `durationMinutes`, `capacity`, `amenities` (todas) e `kind`. Devolve só os recursos que atendem, com os inícios livres, o custo em créditos de cada um, `canAfford` e o saldo de quem chama. Quando nenhum atende, `nextSlots` traz os próximos horários livres do mesmo pedido. Ordem: livres mais cedo e, no empate, a menor capacidade que atende.

Parâmetros

NomeOndeTipoDescrição
spaceIdobrigatórioquerystring (uuid)
startsAtopcionalquerystringHorário exato (hora local sem sufixo).
dateopcionalquerystring
fromopcionalquerystring
toopcionalquerystring
durationMinutesopcionalqueryinteger
capacityopcionalqueryinteger
amenitiesopcionalquerystring
kindopcionalqueryROOM | DESK | STATION | OTHER | PERSON
hostProfileIdopcionalquerystring (uuid)Só agendas desta pessoa.

Headers

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

Respostas

CódigoDescrição
200`results`, `nextSlots`, `balance` e `timeZone`.
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.

Exemplo com curl

curl -X GET "https://api.memberfy.net/api/bookings/search" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"