Recursos
Depois
Quando a fila deve ficar abaixo do seu limite, o horário mais tranquilo, quando sair e uma previsão hora a hora, assim que um lugar tem histórico suficiente para dizer.
O que diz
A resposta para um lugar, GET /v1/places/{id} ou a ferramenta get_wait, sempre tem um bloco next. A visão mínima mantém under, under_status, under_by, best e summary; a visão completa adiciona a confiança e a previsão hora a hora.
Pedir
under | O limite em minutos. Padrões: 30 para prontos-socorros, pronto atendimento e faixas de fronteira, 20 para DMVs, 15 para aeroportos. |
travel_min | Minutos para chegar lá. Adiciona next.leave_by. |
date | Uma data local, de hoje até 7 dias à frente, para planejar esse dia em vez das próximas 24 horas. |
forecast | Com a visão mínima, adiciona uma previsão compacta hora a hora. |
curl "https://api.waity.ai/v1/places/pl_6e3znhb7h9?under=30&travel_min=20&view=full" \
-H "X-Api-Key: $WAITY_API_KEY"
Resposta
{
"next": {
"for_date": null,
"summary": null,
"based_on": "live",
"under": 30,
"under_status": "expected",
"under_by": "2026-10-30T16:45:00-06:00",
"best": {
"from": "2026-10-31T01:00:00-06:00",
"to": "2026-10-31T02:00:00-06:00",
"value": 6
},
"leave_by": "2026-10-30T16:25:00-06:00",
"confidence": "medium",
"days_of_history": 23,
"forecast": [
{
"at": "2026-10-30T14:00:00-06:00",
"open": true,
"open_minutes": 60,
"value": 48
},
{
Vai ficar abaixo do limite?
under_status responde, com next.under_by quando se espera uma queda:
already | A espera ao vivo está no limite ou abaixo dele agora. |
usually_under | Sem leitura ao vivo, mas nesta hora costuma ficar abaixo dele. |
expected | A previsão fica abaixo dele; next.under_by diz quando. |
not_expected | A previsão não fica abaixo dele dentro da janela. |
not_now | A espera ao vivo está acima dele, e ainda não há previsão para dizer quando cai. |
no_data | Sem leitura ao vivo e sem previsão. |
closed_all_day, closed_rest_of_day | Fechado o dia todo, ou pelo resto do dia. |
not_published | O lugar não publica sua espera. |
Previsão
next.forecast tem um espaço por hora para as próximas 24 horas, ou para o dia em date: at, se está open e por quantos minutos, e value. next.confidence é a mais fraca entre as horas abertas, e next.days_of_history conta os dias de histórico por trás dela.
next.based_on é live quando a leitura mais recente entra no cálculo, e usual quando a previsão é só o padrão habitual.
Melhor horário
next.best é a hora mais tranquila em que o lugar fica aberto por pelo menos 45 minutos, com a espera prevista. É null para prontos-socorros e pronto atendimento, já que ninguém deve escolher a hora de uma emergência, e quando o dia é uniforme.
Horário de saída
Com travel_min, next.leave_by é agora quando a fila já está (ou costuma estar) curta, ou então quando sair para chegar quando ela cair. É null quando não se espera queda, ou quando você chegaria depois do fechamento; um aviso diz isso.
Planejar um dia
Com date, até 7 dias à frente, next cobre esse dia local: next.for_date o indica, e next.summary dá o horário de funcionamento e o momento mais tranquilo, pronto para repetir. Um dia em que o lugar está fechado aparece como closed_all_day.
Primeiro, histórico suficiente
Valores de previsão, next.under_by, next.best e a espera habitual só aparecem com confiança média ou alta. Isso exige pelo menos 10 dias de histórico para a hora, e esperas estáveis o bastante de uma hora para outra. Até lá, são null, e diagnostics diz por quê.
Assim, um lugar novo diz isso em vez de adivinhar: diga ao usuário que ainda não há previsão e cite a espera ao vivo. Nunca apresente o horário de funcionamento como o melhor horário para ir.
Relacionado
Como ler uma resposta explica cada campo. Os parâmetros estão em API REST e MCP, e todos os campos estão na Referência da API.