Funciones
Después
Cuándo debería bajar la fila de tu umbral, la hora más tranquila, cuándo salir y una previsión por hora, en cuanto un lugar tiene historial suficiente para decirlo.
Qué dice
La respuesta de un lugar, GET /v1/places/{id} o la herramienta get_wait, siempre tiene un bloque next. La vista mínima conserva under, under_status, under_by, best y summary; la vista completa añade la confianza y la previsión por hora.
Pedir
under | El umbral en minutos. Por defecto: 30 para urgencias, atención urgente y carriles fronterizos, 20 para DMV, 15 para aeropuertos. |
travel_min | Minutos para llegar. Añade next.leave_by. |
date | Una fecha local, de hoy hasta 7 días por adelantado, para planear ese día en vez de las próximas 24 horas. |
forecast | Con la vista mínima, añade una previsión por hora compacta. |
curl "https://api.waity.ai/v1/places/pl_6e3znhb7h9?under=30&travel_min=20&view=full" \
-H "X-Api-Key: $WAITY_API_KEY"
Respuesta
{
"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
},
{
¿Bajará del umbral?
under_status responde, con next.under_by cuando se espera una bajada:
already | La espera en vivo está ahora en el umbral o por debajo. |
usually_under | No hay lectura en vivo, pero a esta hora suele estar por debajo. |
expected | La previsión baja del umbral; next.under_by dice cuándo. |
not_expected | La previsión no baja del umbral en el intervalo. |
not_now | La espera en vivo está por encima, y aún no hay previsión que diga cuándo baja. |
no_data | Ni lectura en vivo ni previsión. |
closed_all_day, closed_rest_of_day | Cerrado todo el día, o el resto del día. |
not_published | El lugar no publica su espera. |
Previsión
next.forecast tiene una franja por hora para las próximas 24 horas, o para el día de date: at, si está open y durante cuántos minutos, y value. next.confidence es la más baja de las horas abiertas, y next.days_of_history cuenta los días de historial que la respaldan.
next.based_on es live cuando se incorpora la lectura más reciente, y usual cuando la previsión es solo el patrón habitual.
Mejor hora
next.best es la hora más tranquila con al menos 45 minutos abierta, con su espera prevista. Es null para urgencias y atención urgente, porque nadie debería programar una emergencia, y cuando el día es plano.
Hora de salida
Con travel_min, next.leave_by es ahora cuando la fila ya es (o suele ser) corta, o si no, cuándo salir para llegar cuando baje. Es null cuando no se espera una bajada, o cuando llegarías después del cierre; un aviso lo indica.
Planear un día
Con date, hasta 7 días por adelantado, next cubre ese día local: next.for_date lo indica, y next.summary da el horario y la hora más tranquila, listo para repetir. Un día en que el lugar está cerrado dice closed_all_day.
Primero, historial suficiente
Los valores de la previsión, next.under_by, next.best y la espera habitual solo aparecen con confianza media o alta. Eso requiere al menos 10 días de historial para esa hora, y esperas lo bastante estables de una hora a otra. Hasta entonces son null, y diagnostics dice por qué.
Así, un lugar nuevo lo dice en vez de adivinar: dile al usuario que aún no hay previsión y cita la espera en vivo. Nunca presentes el horario de apertura como la mejor hora para ir.
Ver también
Cómo leer una respuesta explica cada campo. Los parámetros están en API REST y MCP, y cada campo está en la Referencia de la API.