Hacé una consulta
Enviá GET /api/search?q=cerrar%20caja&limit=8. q es obligatorio, admite hasta 120 caracteres y se recorta en los extremos. limit es opcional: un entero entre 1 y 20; el valor predeterminado es 8.
La búsqueda ignora mayúsculas y tildes, y reconoce equivalencias curadas como “existencias” y “stock”. Consulta los títulos, los encabezados y el texto de las guías. No consulta información del negocio.
Interpretá la respuesta
La respuesta JSON incluye query, results y total. Cada resultado tiene id, title, description, topic, url, markdownUrl, section y snippet. La URL apunta al artículo o a la sección coincidente. total cuenta las secciones coincidentes antes de aplicar el límite.
results: [] con HTTP 200 significa que la consulta es válida y no encontró coincidencias. Podés reformularla o explorar los temas del manifiesto.
Tratá los errores
Una consulta vacía, demasiado larga, con parámetros repetidos o con un límite inválido devuelve HTTP 400. Un fallo del servicio devuelve HTTP 503 y un mensaje genérico. No interpretes un error como una búsqueda sin resultados.
Solo se admite lectura: los métodos de escritura devuelven HTTP 405. No hacen falta credenciales. No envíes contraseñas, datos personales, tickets ni información privada en una consulta pública.