Qual recurso eu consigo?
GET/api/bookings/search
- Auth
- Exige token
- X-CommunityId
X-CommunityIdEnvie 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
| Nome | Onde | Tipo | Descrição |
|---|---|---|---|
spaceIdobrigatório | query | string (uuid) | |
startsAtopcional | query | string | Horário exato (hora local sem sufixo). |
dateopcional | query | string | |
fromopcional | query | string | |
toopcional | query | string | |
durationMinutesopcional | query | integer | |
capacityopcional | query | integer | |
amenitiesopcional | query | string | |
kindopcional | query | ROOM | DESK | STATION | OTHER | PERSON | |
hostProfileIdopcional | query | string (uuid) | Só agendas desta pessoa. |
Headers
| Nome | Tipo | Descrição |
|---|---|---|
X-CommunityIdopcional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Respostas
| Código | Descrição |
|---|---|
200 | `results`, `nextSlots`, `balance` e `timeZone`. |
400 | Requisição inválida — falha de validação. |
401 | Token ausente, inválido ou expirado. |
403 | Autenticado, mas sem permissão para esta operação. |
404 | Recurso não encontrado. |
500 | Erro 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"