1. Обзор
В этой статье мы представляем RESTful API Modeling Language (RAML) , независимый от производителя, язык открытых спецификаций, построенный на http://yaml.org/spec/1.2/spec .html[YAML 1.2]и JSON для описания RESTful API.
Мы рассмотрим базовый синтаксис RAML 1.0 и файловую структуру, демонстрируя, как определить простой API на основе JSON. Мы также покажем, как упростить обслуживание файлов RAML с помощью include . И если у вас есть устаревшие API, которые используют схему JSON, мы покажем, как включать схемы в RAML.
Затем мы представим несколько инструментов, которые могут улучшить ваше путешествие в RAML, в том числе инструменты разработки, генераторы документации и другие.
Наконец, мы подведем итоги, описав текущее состояние спецификации RAML.