# 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)