Где проектировать Restful API?
RAML (самый молодой, но рекомендую)SwaggerApiary
Это фреймоворки для проектировния API. По сути предоставляют свой DSL для описания и ДОКУМЕНТИРОВАНИЯ (!) API. К большинству из них идут инструменты по генерации читабельных доков и всякие mock-инструменты и генераторы клиентов-загрушек и сервисов-заглушек (для тестирования сервисов и клиентов соответственно). Вот например тулзы для Сваггера: swagger.io/swagger-codegen :The Swagger codegen project allows generation of both client libraries and server stubs from a Swagger definition.vREST - более комплексный продукт, включающий автоматизацию тестирования, есть платные возможности.Mashape - большой продукт для предоставления API, используется многими крупными компаниями (напр., Близзы его юзают).
P.S. Есть еще различные модели гипермедийных API (JSON-LD, HAL, Siren, и т.д.), но это пока не очень популярные вещи, поэтому если не готовы быть одним из первопроходцев, лучше попробуйте их потом, когда наберут популярность (если наберут).
на текущий момент все сами придумывают свой "язык апи" для описания своих сервисов, тк нет определённости какой именно функционал и как вы хотите показать через апи.