Язык моделирования RESTful API (RAML)

Язык моделирования RESTful API (RAML, http://raml.org/) - это простой и лаконичный способ описания практически-RESTful API. Он поощряет повторное использование, делает возможным обнаружение и совместное использование шаблонов и нацелен на появление передовых практик на основе заслуг. Цель состоит в том, чтобы помочь нашей нынешней экосистеме API, решая насущные проблемы, а затем поощрять создание еще более совершенных шаблонов API. RAML построен на широко используемых стандартах, таких как YAML и JSON, и является открытой спецификацией, не являющейся частной собственностью и не зависящей от производителя.

Язык моделирования RESTful API (RAML) упрощает управление всем жизненным циклом API от проектирования до совместного использования. Это кратко - вы пишете только то, что вам нужно определить, - и можно использовать повторно. Это машиночитаемый дизайн API, который на самом деле удобен для человека.