Apiary

Apiary — это как GitHub, только не для исходников, а для очень удобного описания, тестирования, и документирования любого API.

Особенности сервиса

• Apiary использует в качестве разметки API blueprint, разработанного на базе синтаксиса Markdown.
• Файл с документацией поддерживается редакторами для Markdown.
• Проект имеет хороший онлайн редактор. Заметны баги с версткой сайта, в некоторых местах она недостаточно продумана. Тем не менее, смотрится значительно приятнее Swagger (но это — моя субъективная оценка).
• Поддерживает генерацию примеров запроса для языков: Java, Javascript, Node.js, Perl, Python. PHP, Ruby, Go, C#, Visual Basic, Groovy, Objective-C, Swift.

Преимущества сервиса

• Ваше API очень красиво выглядит и вы можете на него ссылаться
• Пользователи сайта могут получить сразу сгенерированный код для вызова API на следующих языках (curl, javascript, node.js, python, php, ruby)
• Пользователи сайта могут писать комментарии к любому методу API
• Пользователи могут вызвать любой из методов прямо из браузера
• И самое главное — для вашего API автоматически бесплатно создается надежный сервер для тестирования на самом apiary!!! И в нем есть очень удобный дебагер, который показывает, кто и когда посылал запросы и какие были ответы!