Los Brother's Jamay — Plataforma para Agentes y Desarrolladores

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:

# Información del taller (NAP, horarios, GPS):
npx losbrothers info
# Catálogo de servicios y garantías:
npx losbrothers services
# Marcas y modelos compatibles:
npx losbrothers catalog --brand apple
# Cotizar reparación:
npx losbrothers quote --brand Apple --model "iPhone 13" --issue "pantalla rota"

Endpoints de la API v1 (Compatibles con Function Calling)

GET/api/v1/store-infooperationId: getStoreInfo

Datos oficiales NAP de Los Brother's Jamay, dirección física, coordenadas y horarios.

GET/api/v1/servicesoperationId: listRepairServices

Catálogo de servicios de reparación técnica, tiempos de entrega y garantía escrita de 15 días a 2 meses.

GET/api/v1/catalogoperationId: getCatalog

Marcas y modelos con refacciones en almacén. Parámetro: ?brand=apple.

POST/api/v1/quoteoperationId: estimateRepairQuote

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