Devops for Growth

James Higginbotham affirme qu'un processus de conception d'API "encourage l'efficacité tout au long du processus de livraison". Cet effet se produit parce que l’objectif principal est le contrat d’API pour les besoins des utilisateurs et des développeurs. La résilience aux changements d’implémentation interne au fil du temps est un avantage des process de conception d'API.

Le process ADDR de l'auteur divise le processus de conception d'API en cycles composés de sept étapes regroupées en quatre phases. Ces phases (traduites en français) sont Aligner, Définir, Concevoir et Affiner.

L'idée est d'aligner toutes les parties prenantes, puis de traduire leurs exigences dans des définitions de fonctions numériques, résultant en une conception technique d'API. Cette conception est ensuite affinée grâce aux commentaires, à la documentation, au prototypage et aux tests. Étant donné que l'ADDR est un processus itératif, les apprentissages de chaque itération sont pris en compte pour la suivante.

L'auteur souligne que la conception d'une API est une étape distincte et critique de la livraison de logiciels tout en reconnaissant que les équipes peuvent concevoir et livrer des API avec succès sans suivre un processus de conception formel.

D'autres auteurs ont exprimé leur point de vue sur la conception d'API. Ils tendent à converger vers les mêmes conclusions.