Описание
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!!! И в нем есть очень удобный дебагер, который показывает, кто и когда посылал запросы и какие были ответы!
Отзывы
Отзывов пока нет.