¿Por qué no hay temas para swagger-ui?

Me gusta mucho swagger para documentar API Restful, especialmente " Pruébalo!"botón, pero swagger-ui interfaz no se ve muy bien.

Y no puedo creer que no haya plantillas para esta increíble herramienta de código abierto (o no puedo encontrar ninguna)?

No lo quiero gratis.. Como http://getbootstrap.com / tiene muchos sitios para comprar temas (como https://wrapbootstrap.com / ), ¿por qué no puedo encontrar ningún sitio para temas swagger?

Author: Wil Moore III, 2015-01-19
Source

6 answers

Una respuesta tardía, aunque buena. Esto es bastante impresionante! Una implementación ingeniosa, y ha personalizado muchas cosas que son fáciles de ajustar una vez más para sus necesidades: https://github.com/jensoleg/swagger-ui .

Los créditos van a este grupo de Google: https://groups.google.com/forum/#! topic/swagger-swaggersocket / oeMyayrvKRI. Es extraño que esto no se haya publicado aquí todavía.

Para una demostración de acción, por favor echa un vistazo a este enlace: http://senodio.com/site/swagger/#! / pet / addPet

--

EDITAR: Recientemente descubrí que la DEMO está inactiva, así que bifurcé el Repositorio ( https://github.com/MartinSahlen/swagger-ui ) y creó un simple servidor node / express que se ejecuta en heroku. Tenga en cuenta que este es un banco de pruebas heroku gratuito, por lo que podría tardar un tiempo en cargarse (~20 segundos) si hay poca actividad en él durante algún tiempo.

De nada: http://sleepy-harbor-80783.herokuapp.com/#! / pet / addPet

EDITAR 2: Acabo de encontrarme con otro que parece prometedor.: https://github.com/legendecas/material-swagger-ui . También parece que la interfaz de usuario swagger que estoy alojando ahora se resucita en http://swaggerui.herokuapp.com / . Mantener el mío también en caso de que se retire de nuevo.

 65
Author: martin.code,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2017-01-24 16:29:50

Esta es una colección de temas de hojas de estilo que se pueden aplicar a la interfaz de usuario de Swagger. Enlace a continuación a mi repositorio sobre cómo usar.

Espero que esto ayude.

Https://github.com/ostranme/swagger-ui-themes

 13
Author: ostranme,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2016-03-27 13:34:00

Swagger-UI, aunque no es una herramienta nueva, es muy específica para su tarea. No soy consciente de cualquier sitio web que proporciona temas para él (gratis o de pago). Muchos de sus usuarios han personalizado la interfaz de usuario para adaptarse a su tema local. Algunos han hecho cambios sutiles, otros una revisión completa.

Te recomiendo que eches un vistazo a las implementaciones disponibles y veas si algo se adapta a tus necesidades. Entonces tal vez pedir permiso para reutilizar su tema/plantilla para sus propias necesidades.

 4
Author: Ron,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2015-01-19 21:10:15

Recientemente he refactorizado el tema swagger-ui compartido anteriormente usando bootstrap v4 para cualquiera que esté interesado. Ver aquí https://github.com/afgarcia86/bootstrap-swagger-ui

 2
Author: Andres F Garcia,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2018-01-03 03:53:34

Otra opción es ReDoc.

Solo tienes que traer tu arrogancia.archivo json con un índice .html . Fácil instalación.

<head>
    <title>ReDoc</title>
    <meta charset="utf-8"/>
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
    <style>
      body {
        margin: 0;
        padding: 0;
      }
    </style>
  </head>
  <body>
    <redoc spec-url='your.swagger.json'></redoc>
    <script src="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"> </script>
  </body>
 2
Author: user1917528,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2018-04-03 22:53:56

Puede usar swagger-boostrap-ui

Github: https://github.com/xiaoymin/Swagger-Bootstrap-UI

Soporta markdown de exportación de api y así sucesivamente...

 0
Author: xiaoym,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2018-09-28 04:41:04