Вопросы Теги

как генерировать вывод в swagger [duplicate]

Это не связано с исходным вопросом, но у меня было такое же сообщение об ошибке, и этот поток стал первым хитом в Google, и мне потребовалось некоторое время, чтобы выяснить, в чем проблема, поэтому он может быть полезен для другие:

Я НЕ использую mysqli, все еще используя mysql_connect. У меня были некоторые простые запросы, но один запрос заставил все остальные запросы сбой в одном и том же соединении.

Я использую mysql 5.7 и php 5.6 у меня была таблица с типом данных «JSON». очевидно, моя php-версия не распознала возвращаемое значение из mysql (php просто не знал, что делать с JSON-Format, потому что встроенный mysql-модуль был слишком старым (по крайней мере, я думаю))

на данный момент я изменил тип JSON-Field-Type на Text (так как теперь мне не нужна собственная функция mysql JSON), и все работает отлично

2
задан Peter Krauss 28 June 2017 в 14:07
поделиться

2 ответа

Благодаря @tleyden в swagger-ui / issues для хороших подсказок!

Используйте папку index и assets этого проекта, https: // github.com/okfn-brasil/swagger-ui-html

0
ответ дан Peter Krauss 16 August 2018 в 03:58
поделиться

«Красивый интерфейс» на вашем скриншоте - Swagger UI . Это бесплатно и с открытым исходным кодом. В http://petstore.swagger.io есть демо, где вы можете загрузить свои собственные .json / .yaml-файлы из URL-адреса и посмотреть, как они будут отображаться.

Чтобы использовать пользовательский интерфейс Swagger локально:

  1. Перейдите в https://github.com/swagger-api/swagger-ui и загрузите репозиторий как ZIP: Download Swagger UI [/g8]
  2. Отредактируйте файл dist\index.html и измените строку 
    url: "http://petstore.swagger.io/v2/swagger.json",
    на URL вашего файла Swagger .json или .yaml, например 
    url: "http://api.mysite.com/swagger.json",
  3. (Необязательно) Добавьте / измените другие параметры конфигурации в коде инициализации SwaggerUIBundle в dist\index.html.
  4. Откройте dist\index.html файл в вашем браузере, чтобы просмотреть ваши документы API. Примечание. Если спецификация не загружается или «попробуйте» не работает, вам, вероятно, необходимо включить CORS на вашем сервере. См. https://github.com/swagger-api/swagger-ui#cors-support и https://enable-cors.org .
  5. Загрузите файлы из папки dist где-то на ваш сервер - и теперь у вас есть довольно API-документы!

Alternativey, SwaggerHub (о котором вы упомянули ) обеспечивает облачный хостинг для спецификаций Swagger, среди прочего, и имеет интегрированный интерфейс Swagger. Вы можете импортировать файлы Swagger .json / .yaml и иметь свои документы API, размещенные на SwaggerHub. Доступен свободный план .

2
ответ дан Helen 16 August 2018 в 03:58
поделиться
  • 1
    Привет, спасибо @Helen (!). Hum ... Понимаю, измените petstore на мой URL-адрес только для работы ... Но вы не показываете, как загрузить с него автономный HTML-файл (автономный). Можете ли вы показать пошаговые инструкции для этого? Без загрузки нет решения проблемы вопроса. – Peter Krauss 28 June 2017 в 15:40
  • 2
    PS: "из репозитория, отредактируйте dist \ index.html & quot; не имеет смысла без URL-адреса или подробных инструкций – Peter Krauss 28 June 2017 в 15:42
  • 3
    Спасибо @Helen за инструкции (!) ... Но это то же самое & quot; с рекламой & quot; страница (с «зеленой навигационной панелью»). Является ли половинным решением (проголосовали, но не принято): кажется очень сложно снять рекламный бар. Это потеряет мое время без гарантии успеха. – Peter Krauss 28 June 2017 в 17:56
  • 4
    github.com/swagger-api/swagger-ui/issues/3313 – Peter Krauss 28 June 2017 в 18:01
  • 5
    @PeterKrauss, я предлагаю вам задать новый вопрос об этом. Последующие вопросы не подходят для комментариев. – Helen 28 June 2017 в 18:42
Другие вопросы по тегам:

Похожие вопросы: