#code #web #tools #open-source

La OpenAPI Specification (OAS) standardise la description d’API. L’OpenAPI Description document consiste en un fichier YAML (ou JSON) décrivant chaque endpoint, les paramètres attendus ainsi que les réponses revoyées. La spécification est agnostique du langage utilisé, tant que l’API est basé sur HTTP.

Le document OpenAPI, étant un format standard assez répandu, permet de définir proprement l’API et ainsi d’augmenter la lisibilité pour les développeurs. Il existe de nombreux outils se basant sur le document OpenAPI Description, tel que la génération de docs, la génération de code client (SDK), la validation de données, la création de serveurs mocks, le testing automatique des endpoints, et d’autes.

OpenAPI, initialement appelée Swagger, est actuellement dans sa version 3.1. La spécification est soutenue par l’OpenAPI Initiative, qui est une organisation en gouvernance ouverte, sous la Linux Foundation.

Le site web officiel: https://www.openapis.org/