Новые документы Stoplight, API Stoplight, RAML 1.0, 5x Faster API Docs

Сентябрь был очень занят в штаб-квартире Stoplight!

Документация по новому стоп-сигналу

Наконец-то мы нашли время, чтобы обновить нашу собственную документацию. Вы можете найти ~30 новых статей на https://help.stoplight.io. Наш новый справочный портал охватывает платформу Stoplight, наш новый API и среду выполнения Prism. У нас есть еще около 20 статей на октябрь.

О, и он питается от Stoplight! В октябре этого года мы представляем новый продукт для размещения документации — уровень портала. Он будет стоить 199 долларов и позволит вам объединить множество опубликованных документов в один портал с расширенным поиском и другими замечательными функциями.

Предложение ограничено по времени — если вам нужен справочный портал, такой как https://help.stoplight.io, отправьте нам электронное письмо по адресу [email protected], и мы назначим специального инженера, который настроит его для вас, и сделать его идеальным.

Новый API стоп-сигнала

Одной из наиболее востребованных функций была возможность программно включать и отключать OAS/Swagger/RAML от Stoplight. Сегодня мы выпускаем общедоступный API Stoplight, который упрощает подключение существующих процессов к платформе Stoplight. Подробнее об этом читайте в нашей документации по API.

RAML 1.0

Вторая наиболее востребованная функция — добавлена ​​поддержка RAML 1.0! Воспользуйтесь новейшими и лучшими технологиями, а также импортируйте/экспортируйте RAML 1.0 прямо из приложения Stoplight.

Документы по API в 5 раз быстрее + ​​имитация

Мы понимаем, что скорость важна, поэтому мы прилагаем все усилия, чтобы сделать документы API максимально быстрыми. Мы пересмотрели всю архитектуру документации по API, и теперь она почти полностью статична (без участия сервера) и быстро загружается. Просто ознакомьтесь с Giphy API Docs. Мы опишем эту новую архитектуру более подробно в октябре в нашем блоге. Кроме того, при желании разрешите читателям вашей документации отправлять тестовые запросы к фиктивной версии вашего API.