Importando OpenAPI / Swagger

¿por qué usar la importación de openapi? si tu producto está diseñado para desarrolladores o tu producto tiene una api, necesitas una gran documentación del producto; de lo contrario, no podrás llegar a los desarrolladores una vez que importes tu archivo openapi, archbee lo leerá y lo convertirá en una hermosa interfaz de usuario y lo hará listo para ser compartido públicamente (en un dominio personalizado) internamente con tus colegas y equipos una vez importado, puedes sincronizar, actualizar y probar tu openapi consulta más detalles en las secciones a continuación reglas y configuraciones predeterminadas los archivos openapi importados no pueden ser modificados manualmente en archbee para actualizar y mantener tu openapi, consulta nuestra docid\ nu5xpeiz8gz9325ce5jxk versiones de openapi soportadas archbee actualmente soporta las siguientes versiones de openapi para ser importadas versión 2 0 y 2 0 xx versión 3 0 y 3 0 xx versión 3 1 y 3 1 xx métodos de autenticación soportados archbee actualmente soporta los siguientes métodos de autenticación https //swagger io/docs/specification/authentication/basic authentication/ https //swagger io/docs/specification/authentication/api keys/ https //swagger io/docs/specification/authentication/bearer authentication/ si importas archivos openapi con otros métodos de autenticación, se importarán correctamente y el método de autenticación será ignorado esto significa que obtendrás toda la experiencia de openapi de archbee, excepto la función probar, si tu endpoint requiere una autenticación que no está en la lista anterior otros si defines un " valor predeterminado " en tus parámetros de openapi y le das un valor, el ejemplo de código y el cuadro de parámetros se pre poblarán automáticamente con ese valor esto facilita que tus usuarios o clientes prueben tu api con docid\ e5zdeytlfnnhp4wh6 6m sin tener que actualizar todos los parámetros requeridos si defines un " ejemplo " parámetro en tu openapi, el valor del ejemplo se mostrará en el lado izquierdo justo debajo del parámetro de la api esto facilita a tus usuarios identificar qué tipo de entrada se necesita para ese parámetro específico ¿cómo funciona? importa tu archivo openapi usando el importar contenido o usa importar opción de cada espacio o sincroniza tus archivos openapi directamente desde tu docid\ n6jj6 lolgemnetmb4fj repositorio con archbee's docid\ n6jj6 lolgemnetmb4fj puedes agregar y sincronizar tus archivos openapi directamente desde tu repositorio vista previa y docid\ e5zdeytlfnnhp4wh6 6m tu openapi importado vista previa y prueba de tu openapi recién importado con archbee's docid\ e5zdeytlfnnhp4wh6 6m característica publicar o compártelo con tus colegas o clientes! publíquelo en vista previa o en un dominio personalizado y hágalo disponible para sus colegas, equipos o usuarios si deseas proteger el contenido y compartirlo solo con unos pocos seleccionados, consulta nuestras docid\ nkogchhwnaziykypvbfmd opciones para portales publicados mantener, sincronizar y configurar docid\ nu5xpeiz8gz9325ce5jxk docid\ nu5xpeiz8gz9325ce5jxk docid\ nu5xpeiz8gz9325ce5jxk aquí hay un video de cómo funciona