Documentación de API — Los Brother's Jamay
Especificación técnica, esquema OpenAPI 3.1.0 y endpoints REST públicos diseñados para agentes autónomos de IA, herramientas LLM (function calling) e integradores de software.
Lineamientos de la API y Autenticación
Los endpoints públicos de Los Brother's Jamay son de libre lectura para agentes de IA y sistemas externos. No requieren autenticación con API key para consultar información de la sucursal, catálogo ni estimaciones de cotización.
- Formato universal: Todas las respuestas se emiten en formato JSON con codificación UTF-8.
- Errores semánticos: En caso de falla, siempre se retorna código HTTP 4xx/5xx con objeto JSON explicativo.
- Compatibilidad LLM: Cada operación cuenta con su respectivo operationId único para function calling.
Endpoints Disponibles
/api/store-infooperationId: getStoreInfoDevuelve los datos oficiales del negocio (NAP), dirección en Jamay, Jalisco, coordenadas geográficas, horarios de atención y áreas atendidas (Jamay, Ocotlán, La Barca, Poncitlán).
/api/servicesoperationId: listRepairServicesLista completa de servicios técnicos: pantallas OLED/AMOLED, baterías con celdas de alta densidad, puertos de carga con microsoldadura, cámaras y rescate de equipos mojados.
/api/catalogoperationId: getCatalogMarcas y modelos atendidos. Soporta parámetro opcional de consulta: ?brand=apple o ?brand=samsung.
/api/quoteoperationId: estimateRepairQuoteGenera una cotización estimada y viabilidad de reparación a partir de los campos brand, model y issue.
Estructura Estándar de Errores JSON
Si un parámetro es erróneo o se consulta un endpoint que no existe, la API siempre responde con código HTTP adecuado y un objeto error estructurado:
{
"error": {
"code": "MISSING_BRAND",
"message": "El campo 'brand' es obligatorio.",
"hint": "Especifica la marca del dispositivo. Consulta /api/catalog para ver marcas soportadas."
}
}