Le pour et le contre. Ce que OpenAPI fait bien, et quand il coûte trop.
Pour. Ce qui joue en sa faveur.
- Standard ouvert et vendor-agnostique (aucun verrouillage).
- Entièrement gratuit avec un riche écosystème d'outils open source.
- Documentation et code client générés automatiquement.
- Compris et reconnu par toute l'industrie web.
- Facilite la collaboration entre équipes et entreprises.
- Support natif pour le versioning et la compatibilité.
- Vous avez besoin d'une interface commune entre équipes (front/back).
- Vous voulez générer automatiquement du code client.
Contre. Ce qu’il faut anticiper.
- Courbe d'apprentissage du format (JSON/YAML).
- Peut être verbeux pour des API très simples.
- Nécessite une maintenance régulière pour rester synchronisée.
- Outils tiers variables en qualité et support.
- Vous préférez la documentation manuelle ou informelle.
- Votre équipe n'a aucune familiarité avec le format.
