SKILLS  ·  Desarrollo y Código  ·  APIs e Interfaces

APIs e Interfaces

API and Interface Design

GitHub
Funciones y alcance
Guía el diseño de interfaces y APIs estables, limpias y difíciles de usar erróneamente. Aplica principios como Contract-First, Hyrum's Law (todo comportamiento observable se convertirá en contrato) y The One-Version Rule.
# API and Interface Design

## Principios Fundamentales
1. **Contract First**: Define siempre la interfaz antes de escribir la implementación. El contrato es la especificación.
2. **Hyrum's Law**: Cualquier comportamiento observable de una API (incluidos formatos de error o tiempos) será asumido por alguien como contrato. No expongas detalles de implementación.
3. **The One-Version Rule**: Evita forzar al consumidor a lidiar con múltiples versiones en conflicto. Diseña contratos extensibles hacia adelante.
4. **Validación Temprana**: Valida esquemas y entradas en la frontera de la API, devolviendo respuestas de error tipadas y legibles.
por Addy Osmani 04/10/2026