Los Brother's Jamay — Documentación de API v1
Especificación técnica, esquema OpenAPI 3.1.0, herramienta CLI oficial y endpoints REST versionados para agentes autónomos de IA y llamadas de función (function calling).
Políticas de API: Versionado, Deprecación y Límites
Versionado REST
Estrategia en la URL: /api/v1/. Se emite la cabecera X-API-Version: 1.0.0 en cada respuesta.
Política de Deprecación
Ventana mínima de 6 meses antes de sunset. Los endpoints obsoletos emiten cabeceras RFC 8594 (Deprecation y Sunset).
Límites (Rate Limiting)
60 req/minuto por IP. Cabeceras RFC: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset y Retry-After en 429.
Herramienta CLI Oficial (npx losbrothers)
Los agentes y desarrolladores pueden interactuar directamente mediante la CLI sin requerir scripts adicionales:
Endpoints de la API v1 (Compatibles con Function Calling)
/api/v1/store-infooperationId: getStoreInfoDatos oficiales NAP de Los Brother's Jamay, dirección física, coordenadas y horarios.
/api/v1/servicesoperationId: listRepairServicesCatálogo de servicios de reparación técnica, tiempos de entrega y garantía escrita de 15 días a 2 meses.
/api/v1/catalogoperationId: getCatalogMarcas y modelos con refacciones en almacén. Parámetro: ?brand=apple.
/api/v1/quoteoperationId: estimateRepairQuoteEstima viabilidad de reparación a partir de brand, model e issue.
Formato Estándar de Errores JSON
Toda respuesta 4xx/5xx emite código semántico, mensaje y sugerencia para el agente:
{
"error": {
"code": "MISSING_BRAND",
"message": "El campo 'brand' es obligatorio.",
"hint": "Especifica la marca del dispositivo. Consulta /api/v1/catalog para marcas soportadas."
}
}