Guías
Ubicación y seguridad
Dónde está el usuario decide qué lugares se devuelven. Envía la ubicación de forma explícita, mantenla fuera de las URL y nunca dejes que una estimación elija unas urgencias.
Enviar una ubicación
Envía la ubicación del usuario en el encabezado X-Waity-Location: lat,lng: así queda fuera de las URL y los registros. near también funciona, igual que una ciudad o código postal en q.
curl "https://api.waity.ai/v1/places?category=border&view=minimal" \
-H "X-Waity-Location: 31.759,-106.487"
Si no sabes dónde está el usuario
Pide su ciudad o código postal, o lat y lng, antes de llamar.
Cuándo estima Waity
Solo para REST GET /v1/places con una pregunta “near me” sin ubicación, desde una red de banda ancha doméstica, con un navegador o un cliente tipo curl. Nunca para MCP, get_wait, redes de nube o de centros de datos, VPN, redes móviles, scripts en una página web ni agentes de IA. La respuesta indica entonces query.resolved.source: "ip".
Desactivar la estimación
Envía X-Waity-Location: none y Waity nunca estima; la solicitud se trata como si no tuviera ubicación.
curl
curl "https://api.waity.ai/v1/places?q=ER+near+me&view=minimal" \
-H "X-Waity-Location: none"
Respuestas de urgencias
- Cuando la ubicación se estimó,
warnings[1]lo indica: pide la ubicación real antes de elegir unas urgencias. - Waity solo sigue algunas urgencias y centros de atención urgente, así que sus listas tienen cobertura partial: nunca digas que los resultados son los más cercanos.
Reglas de seguridad
- La atención urgente es solo para enfermedades o lesiones leves, nunca para una emergencia.
- Las esperas fronterizas son solo para entrar a EE. UU.; Waity no tiene ninguna para salir.
- Las reglas de cada lugar, como las puertas que atiende un control o lo que cuenta un número del DMV, vienen en las notes de cada respuesta: repítelas.