Swagger / OpenAPI
API Clients specification
Specification for REST API documentation
Pros and Cons
Ventajas
- + Industry standard
- + Interactive documentation
- + Code generation
- + Automatic validation
Desventajas
- - Keeping sync with code
- - YAML can be verbose
- - Initial learning curve
Casos de Uso
- API documentation
- SDK generation
- Contract-first development