3 лучших инструмента для описания RESTful API

[@uniqby]

Буквально вчера искал что-то для себя и мне понравился вот этот инструмент apidocjs.com. Умеет генерировать приятную на глаз документацию прямо из комментариев к иходному коду (phpDoc).

[@Ghostwriter]

raml.org

[@ArthurKushman]

Тотально согласен — 2017г и RAML активно развили до версии 1.0
Запрогал авто-генератор для Laravel, с поддержкой JSON API — https://github.com/RJAPI/raml-json-api
(Контрибы и предметная критика приветствуется)

PS Insanity is doing the same thing over and over again, expecting different results. Albert Einstein
По сему коллеги — давайте перестанем «кодить» свои велосипеды и начнем работать с качественными форматами представления входных/выходных данных и их описанием. (нисколько не отменяет попыток изобретать что-нибудь новое, академически весомое)

[@Ghostwriter]

Вопрос тем, кто использовал Swagger 2.0 и RAML. В чём их принципиальное отличие друг от друга? Какая из спецификаций охватывает большее число возможных кейсов (например, возможность явно указывать протокол)?

[@Tel]

Slate?

[@asci]

О, спасибо! очень крутая штука

[@Tel]

Если будете делать что-то, напишите мне.
Мы давно хотим перевести наш АПИ с html файликов, на что-то такое, но руки всё не доходят.

[@KIVagant]

Вы спасли мне жизнь :)
Лучшее из всего, что мне попадалось. Как всегда — просто тихим комментарием на гитхабе.

[@w32blaster]

Ещё есть jsondoc.org/

[@Regis]

Впечатляющая подборка. Целых два средства для описания RESTful API!

[@ha2bj]

www.runscope.com/

[@coolweb]

Тоже покадал на этот ресурс. Думаю, он будет хорошим дополнением к разработанному апи.

[@ha2bj]

1 проект я уже пропустил через этот сервис (iOS + php). Очень удобный :)

[@ivlis]

А можно кратно объяснить что это такое вообще и зачем оно нужно? Есть же ASN1 — стандарт описания интерфейсов с кучей написанных генераторов под какие угодно языки программирования?

[@BigD]

А какие вообще стандарты / нотации описания интерфейсов бывают? Для бизнес аналитика, системного аналитика.

[@usualdesigner]

Как обычно, в комментариях намного больше интересного, чем в статье.

P.S. Статья не плохая, просто такова специфика Хабра

[@adametsderschopfer]

Ахахах 3 из 3х инструмента - "Access denied in your contry"