OpenAPI est la norme de référence pour décrire les API RESTful qui permettent l'accès à des tiers, appelées API "ouvertes"
Le terme OpenAPI fait référence à une norme, la spécification OpenAPI (OAS), qui permet de décrire la structure et le fonctionnement d'une API, ou interface de programmation d'application, selon un modèle partagé.
Les OpenAPI peuvent également désigner les interfaces de programmation d'applications (API) qui permettent à des tiers d'accéder à leurs propres données et outils, ce que l'on appelle en Italie, avec des nuances différentes, les API "ouvertes" ou publiques, qui sont accessibles avec des restrictions minimales liées plus souvent à l'utilisation pratique des API qu'au droit d'auteur ou à d'autres éléments similaires.
L'introduction d'une spécification qui fournirait une norme pour les API RESTful était attendue depuis longtemps et a conduit à l'explosion du marché des API en quelques années, qui est maintenant l'un des principaux marchés de l'industrie du logiciel.
En effet, quel pourrait être le sens ultime de l'exposition de ses données, si ce n'est d'en permettre l'utilisation la plus large possible ? Il suffit de penser à l'univers émergent du marché des API pour comprendre le rôle de la norme OpenAPI dans la création de nouveaux produits et de nouvelles fonctionnalités.
Selon Market Data Forecast, le marché mondial des API représentera 8,41 milliards de dollars en 2027, avec une croissance estimée à +34 % par rapport au scénario fourni par les données de 2021. Et même si toutes les API n'adhèrent pas à la norme OpenAPI, il est tout aussi vrai que c'est grâce à la normalisation des définitions, des structures et des processus qu'il a été possible de mettre en œuvre des API pratiquement partout.
Alors que dès 2020, 90% des développeurs déclaraient utiliser des API tierces (données: SlashData), nous savons qu'aujourd'hui, la quasi-totalité des applications que nous utilisons au quotidien communiquent avec d'autres applications via des API. En ce sens, l'introduction d'une spécification standard ouverte telle que l'OpenAPI a fourni une orientation rapide, partagée et sécurisée à la communauté des développeurs et un point zéro à la croissance exponentielle du marché des API.
La spécification OpenAPI (OAS) définit une interface standard pour les API RESTful qui permet aux humains et aux applications logicielles de comprendre la fonctionnalité du service sans avoir à interagir avec le code source ou la documentation originale.
La norme OpenAPI est indépendante du langage de programmation et permet de décrire une API au moyen d'un document au format YAML ou JSON qui répond à certaines exigences communes.
La norme OAS - qui en est à sa version 3.0 - peut être utilisée pour décrire une API RESTful de manière à générer des stubs, c'est-à-dire des portions fonctionnelles de code, ou de la documentation à partir d'une sorte de lingua franca qui facilite les interactions entre les API et accélère considérablement le développement de nouvelles applications, jouant ainsi un rôle central dans l'évolution du marché axé sur les API.
La spécification OpenAPI se trouve désormais dans un dépôt sur GitHub et repose sur des données ouvertes accessibles à l'ensemble de la communauté des développeurs : grâce au travail de l'OpenAPI Initiative, le "langage commun" des API est devenu en 2017 une ressource accessible à l'ensemble de la communauté.
Le 5 avril 2016, Amazon a annoncé que son API Gateway prendrait désormais en charge les définitions Swagger 2.0. Quelques mois plus tôt, le standard Swagger 2.0 avait été donné à l'Open API Initiative, une organisation créée ad hoc par les pères de la Fondation Linux en association avec des entreprises informatiques de premier plan telles que Google, IBM, Microsoft et PayPal.
L'OpenAPI Initiative a été créée dans le but de "créer un modèle de gouvernance ouvert autour de la spécification Swagger" capable de soutenir et d'accélérer l'adoption et la diffusion de Swagger en tant que cadre de base pour la description des API RESTful.
Swagger était le nom de la spécification jusqu'à la publication de sa version 3.0 en 2017 : depuis lors, nous nous référons à la spécification comme OpenAPI, tout en appelant Swagger certains des outils les plus connus pour la mise en œuvre de l'OAS - éditeurs, générateurs de code, bibliothèques et outils de validation d'API qui peuvent générer de nouvelles définitions à partir d'une API existante.
Tout cela s'est produit alors que le monde des applications logicielles connaissait une évolution capitale, avec le passage d'une approche monolithique à ce que l'on appelle l'architecture microservices. La grande majorité des applications quotidiennes, de Netflix aux applications de navigation GPS, consistent désormais en un réseau complexe de microservices et d'API tierces, des éléments intégrés à différents niveaux qui permettent aux entreprises d'exposer des données et des outils au monde extérieur, et d'utiliser ou de mettre en œuvre les ressources d'autrui de la même manière.
OpenAPI est une norme soutenue et adoptée par des entreprises clés du secteur des technologies de l'information, et peut être considérée comme le fruit de l'expérience précieuse de ceux qui ont développé, testé et mis en œuvre des milliers d'API au fil des ans. L'autorité d'une telle source de vérité (source de vérité pour les développeurs) est sans aucun doute l'une des principales raisons pour lesquelles les grandes et les petites entreprises adoptent la norme OpenAPI 3.0.
Mais plusieurs raisons pratiques expliquent également l'énorme popularité du modèle OAS: il s'agit de la spécification REST qui prend en charge plusieurs langages de programmation et qui peut générer des stubs dans le langage requis. La spécification OpenAPI offre également un accès privilégié à tous les outils de l'écosystème Swagger, y compris ceux qui peuvent générer automatiquement de la documentation, des tests et des serveurs fictifs.
Les autres avantages sont essentiellement liés à la nature ouverte du code et des données: la vaste communauté de développeurs travaillant avec des API ouvertes partage le langage, les outils, les ressources et les connaissances, et constitue un atout d'une valeur rare.
Les API sont l'un des outils clés de la transformation numérique: conformément aux meilleures attentes de l'industrie 4.0, l'architecture mise en place par l'univers Open API est un excellent exemple de multiplicateur d'actifs, capable d'agréger et de distribuer des données et des services de manière toujours nouvelle, donnant naissance à tout un marché de produits.
En ce sens, les paiements numériques ont connu une véritable révolution en termes de transformation digitale : la réglementation PSD2, qui entrera en vigueur dans les pays de l'UE en 2019, exige en effet que toutes les transactions de paiement électronique et les données associées soient fournies selon la norme Open Banking, qui prévoit entre autres l'utilisation de services API ouverts et accessibles à des tiers.
Il s'agit d'une innovation qui ouvre un autre marché, celui des services qui pourront utiliser les données exposées par les plateformes pour créer des produits et des applications de plus en plus spécifiques. Selon les données de l'Observatoire des paiements innovants du Politecnico di Milano, 7 institutions bancaires sur 10 s'adaptent à la mesure sans en explorer le potentiel. D'autre part, une réalité intéressante de nouveaux acteurs émerge, dont 55% sont de jeunes entreprises innovantes qui, grâce aux API ouvertes, offrent des services supplémentaires aux consommateurs et des produits de plus en plus ciblés sur les besoins des utilisateurs.