Plataforma para Agentes y Desarrolladores

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

GET/api/store-infooperationId: getStoreInfo

Devuelve 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).

curl -sS https://www.losbrothers.shop/api/store-info
GET/api/servicesoperationId: listRepairServices

Lista 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.

curl -sS https://www.losbrothers.shop/api/services
GET/api/catalogoperationId: getCatalog

Marcas y modelos atendidos. Soporta parámetro opcional de consulta: ?brand=apple o ?brand=samsung.

curl -sS "https://www.losbrothers.shop/api/catalog?brand=apple"
POST/api/quoteoperationId: estimateRepairQuote

Genera una cotización estimada y viabilidad de reparación a partir de los campos brand, model y issue.

curl -sS -X POST https://www.losbrothers.shop/api/quote -H "Content-Type: application/json" -d '{"brand": "Apple", "model": "iPhone 13", "issue": "pantalla rota"}'

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."
  }
}
Los Brother's Jamay — Taller de Reparación de CelularesVolver a la portada
WhatsApp Oficial