Вопросы по теме 'api-doc'

Как документировать параметры функции Python с помощью sphinx-apidoc?
Я пытаюсь очистить свою документацию по коду Python и решил использовать sphinx-doc потому что он хорошо выглядит. Мне нравится, как я могу ссылаться на другие классы и методы с помощью таких тегов, как: :class:`mymodule.MyClass` About my...
18310 просмотров

Установите аннотацию «параметры» в NelmioApiDocBundle
Я создаю API RESTfull, используя Symfony2.1 с FOSRESTBundle, и я использую NelmioApiDocBundle для создания автоматической документации. У меня есть запрос PUT, в котором пользователь должен отправить один параметр, но мне не нужно создавать форму...
1267 просмотров

Разбор аннотаций Джексона с помощью Swagger
По умолчанию Swagger анализирует элементы данных класса, чтобы документировать объекты, используемые в качестве параметров или возвращаемые данной веб-службой. Если вы используете Jackson, аннотации Jackson предоставляют гораздо более точное описание...
2230 просмотров
schedule 08.03.2023

Заголовки разделов Sphinx apidoc для имен модулей / пакетов Python
Когда я запускаю sphinx-apidoc , а затем make html , он создает страницы документов, которые имеют разделы «Подпакеты» и «Подмодули», а также «модуль» и «пакет» в конце каждого имени модуля / пакета в таблице содержания (TOC). Как я могу...
6204 просмотров
schedule 17.10.2023

Как заставить аннотации Nelmio ApiDoc передавать метод запроса в мои формы?
Я использую динамические формы (определяемые как службы (!)), чтобы включать/отключать некоторые поля для конкретного запроса (POST/PUT/PATCH). Я хочу, чтобы это отображалось в ApiDoc автоматически, передавая параметры для формы как описано в...
937 просмотров
schedule 12.09.2023

Grape-Swagger не перечисляет методы, содержащиеся в API на основе винограда
Я использую гем grape-swagger и не могу получить гем на основе Grape API правильно описан в Swagger. Использование: grape (0.11.0) и grape-swagger (0.10.1) Когда я включаю список Swagger json, я получаю этот вывод со списком всех конечных...
264 просмотров
schedule 29.05.2022

Документирование API-интерфейсов Spring OAuth 2.0 с использованием Swagger
Я работаю над настройкой сервера авторизации OAuth 2.0 с использованием безопасности Spring. Я хотел бы задокументировать API-интерфейсы OAuth 2.0 с помощью Swagger. Как мне это сделать?
679 просмотров
schedule 27.04.2023

Как сгенерировать html-документацию API из тестов mocha BDD?
Я работал над проектом с Java-фреймворком Spring Boot, где ребята автоматизировали генерацию документов API. Каждый раз, когда вы запускаете тесты в стиле BDD/Integration, из тестов mocha создается файл blue print API. Затем он запустил схему...
1079 просмотров

Генератор OpenAPI: неверный формат для примера значения типа данных даты. Возможна ли настройка?
Я использую openapi-generator последней версии ( 4.2.2 ) для создания Java Spring API. Конфигурация выглядит так: openApiGenerate { generatorName = "spring" inputSpec = "${projectDir}/src/main/resources/api/users-spec.yaml"...
2769 просмотров

Не удается установить laravel-apidoc-generator из-за вывода: удалить doctrine / inflector 2.0.3
Я пытаюсь установить laravel-apidoc-generator ( https://github.com/mpociot/laravel-apidoc-generator ) в моем последнем Lumen REST API. Это моя версия Lumen: Lumen (8.0.1) (Laravel Components ^8.0) Это моя версия PHP: PHP 7.3.22 . Когда я...
972 просмотров
schedule 28.06.2022