1. Vue d’ensemble
Dans cet article, nous présentons le RAML , langage de spécification ouvert indépendant du vendeur, basé sur http://yaml.org/spec/1.2/spec . .html[YAML 1.2]et JSON pour décrire les API RESTful.
Nous aborderons la syntaxe et la structure de fichier de base de RAML 1.0 en expliquant comment définir une API simple basée sur JSON. Nous montrerons également comment simplifier la maintenance des fichiers RAML en utilisant includes . Et si vous avez des API héritées qui utilisent un schéma JSON, nous montrerons comment incorporer des schémas dans RAML.
Nous présenterons ensuite quelques outils pouvant améliorer votre parcours dans RAML, notamment des outils de création, des générateurs de documentation et autres.
Enfin, nous terminerons en décrivant l’état actuel de la spécification RAML.