Le 5 Avril 2016, Amazon a annoncé une mise à jour de son API de service de gestion connue sous le nom de Amazon API Gateway. Dans cette mise à jour, Amazon API Gateway prend désormais en charge, et d'une manière directe, l’importation des définitions Swagger 2.0.
Swagger est une spécification qui permet aux développeurs d'utiliser un langage de description commun pour représenter des APIs REST. Les développeurs peuvent utiliser les éditeurs Swagger pour modéliser leurs APIs REST et dans le cadre de cette expérience, la documentation et les métadonnées apparaissent via l'outillage. En utilisant les définitions Swagger, les clients mock pour les tests, de même que les SDKs pour de nombreux langages, y compris Java, JavaScript, Ruby, PHP et C # peuvent être créés, accélérant ainsi les délais de développement pour les organisations qui veulent consommer votre API.
Swagger a été une spécification d’API prise en charge par l'API Gateway d'Amazon depuis le lancement du service. Mais, les développeurs devaient auparavant utiliser l'outil Swagger Importer pour importer les définitions Swagger dans l’API Gateway. L'outil Swagger Importer est disponible sur Github et fournit une expérience de l'outil en ligne de commande.
Image Source: http://swagger.io/getting-started-with-the-amazon-swagger-importer/
À partir de maintenant, les développeurs peuvent utiliser AWS Management Console, Command Line Interface (CLI) ou le SDK. Avec l’utilisation d’AWS Management Console, les développeurs ont la possibilité de :
- Créer une nouvelle API
- Cloner une API existante
- Importer à partir de Swagger
- Voir une API Exemple
Image Source: http://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-create-api-from-example.html
Au 1er janvier 2016, la spécification Swagger a été donnée à l’Open API Initiative (OAI). Le but de l'OAI est de réunir les vues similaires des organisations intéressées à normaliser la description des APIs REST. L'OAI fonctionne dans une structure de gouvernance ouverte sous la Fondation Linux et possède de nombreux leaders dans l'industrie en tant que membres, y compris Google, Apigee, Atlassian, IBM, Intuit, Microsoft et PayPal pour ne citer que quelques-uns.
Swagger n’est pas la seule spécification d'API prise en charge par Amazon API Gateway. Le service prend également en charge une spécification concurrente appelée RAML. Au moment de la rédaction de cet article, Amazon a indiqué que "les clients utilisant les définitions RAML devraient pour le moment continuer à utiliser aws-apigateway-importer". RAML est un groupe de travail ouvert dirigé par MuleSoft et qui a le support d'autres membres, y compris Cisco (un investisseur MuleSoft), VMWare et Akana.