Обновить

Комментарии 19

Буквально вчера искал что-то для себя и мне понравился вот этот инструмент apidocjs.com. Умеет генерировать приятную на глаз документацию прямо из комментариев к иходному коду (phpDoc).
Тотально согласен — 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
По сему коллеги — давайте перестанем «кодить» свои велосипеды и начнем работать с качественными форматами представления входных/выходных данных и их описанием. (нисколько не отменяет попыток изобретать что-нибудь новое, академически весомое)
Вопрос тем, кто использовал Swagger 2.0 и RAML. В чём их принципиальное отличие друг от друга? Какая из спецификаций охватывает большее число возможных кейсов (например, возможность явно указывать протокол)?
О, спасибо! очень крутая штука
Если будете делать что-то, напишите мне.
Мы давно хотим перевести наш АПИ с html файликов, на что-то такое, но руки всё не доходят.
Вы спасли мне жизнь :)
Лучшее из всего, что мне попадалось. Как всегда — просто тихим комментарием на гитхабе.
Впечатляющая подборка. Целых два средства для описания RESTful API!
Тоже покадал на этот ресурс. Думаю, он будет хорошим дополнением к разработанному апи.
1 проект я уже пропустил через этот сервис (iOS + php). Очень удобный :)
А можно кратно объяснить что это такое вообще и зачем оно нужно? Есть же ASN1 — стандарт описания интерфейсов с кучей написанных генераторов под какие угодно языки программирования?
А какие вообще стандарты / нотации описания интерфейсов бывают? Для бизнес аналитика, системного аналитика.
Как обычно, в комментариях намного больше интересного, чем в статье.

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

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

в VS Code установил OpenAPI (Swagger) Editor.

Насколько я понял есть аналогичные плагины для JetBrains и Eclipse

https://marketplace.visualstudio.com/items?itemName=42Crunch.vscode-openapi

https://plugins.jetbrains.com/plugin/14837-openapi-swagger-editor/versions/stable/615565

https://marketplace.eclipse.org/content/openapi-swagger-editor

Зарегистрируйтесь на Хабре, чтобы оставить комментарий

Публикации