28 lines
761 B
Markdown
28 lines
761 B
Markdown
# 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](../00-analisis-referencias/gamilit/backend-patterns.md)
|