ADR-008: API Design RESTful

Estado: Aceptada | Fecha: 2025-11-23 | Responsable: Architecture-Analyst

Decisión

RESTful APIs con:

Versionado: /api/v1/
OpenAPI 3.0 documentation
Consistent error responses
HATEOAS links (opcional)

Justificación

Referencia a Gamilit

REST es estándar industria
OpenAPI auto-documentation
Versionado permite cambios sin breaking

Referencia a Odoo

Odoo usa XML-RPC (legacy), REST es más moderno

Consecuencias

Positivas: Estándar industria, fácil consumir por clientes, documentación auto-generada Negativas: No es tan performante como GraphQL (aceptable para ERP)

Referencias

Gamilit Backend Patterns

761 B Raw Blame History