Busca de pessoas com horários livres
GET/api/scheduling/hosts
- Auth
- Requiere token
- Quién puede:
- owner
- X-CommunityId
X-CommunityIdEnvía el X-CommunityId de la comunidad en la que ocurre la operación.
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.
Quem acessa o space. Devolve só quem tem horário livre na janela, cada pessoa com as suas agendas, o total de horários livres e os próximos 3 (`nextSlots`), cada um dizendo se é gratuito (`free`) ou o custo em créditos (`creditCost`) e se o saldo de quem chama cobre (`canAfford`, falso também quando o plano em atraso ou pausado não pode gastar crédito, a mesma regra de reservar). Sem `date`, a janela são os próximos 14 dias. Quando ninguém tem horário, `data.nextSlots` sugere os mais próximos de qualquer pessoa. Agenda cujo dono perdeu o papel exigido ou o acesso ao space não aparece; a própria agenda de quem chama também não. Horário sem sufixo é a hora local da comunidade.
Parámetros
| Nombre | Dónde | Tipo | Descripción |
|---|---|---|---|
spaceIdobligatorio | query | string (uuid) | |
qopcional | query | string | Parte do nome da pessoa ou da agenda. |
dateopcional | query | string | Dia (AAAA-MM-DD, hora local da comunidade). |
fromopcional | query | string | Início da janela do dia. |
toopcional | query | string | Fim da janela do dia. |
durationMinutesopcional | query | integer | |
hostProfileIdopcional | query | string (uuid) | |
pageopcional | query | integer | |
limitopcional | query | integer |
Headers
| Nombre | Tipo | Descripción |
|---|---|---|
X-CommunityIdopcional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Respuestas
| Código | Descripción |
|---|---|
200 | Pessoas. |
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. |
Ejemplo con curl
curl -X GET "https://api.memberfy.net/api/scheduling/hosts" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID"