La guía paso a paso o código que encontrarás en este artículo es la solución más eficiente y efectiva que hallamos a esta duda o dilema.
Solución:
Hice una búsqueda en Github y encontré algunos proyectos (SDK) generados por Swagger-Codegen.
Aquí hay un ejemplo: Online Convert API2 Swift SDK
También puede consultar la página de Swagger-Codegen Github para una discusión sobre el caso de uso de Swagger-Codegen
ACTUALIZACIÓN: Aquí hay algunas, pero no todas las empresas / proyectos que utilizan Swagger Codegen en producción: https://github.com/swagger-api/swagger-codegen#companiesprojects-using-swagger-codegen
Nota: A partir de julio de 2017, Swagger Codegen ofrece más de 70 generadores para cliente API, stubs de servidor y documentación API.
ACTUALIZACIÓN: En mayo de 2018, alrededor de 50 colaboradores principales y creadores de plantillas de Swagger Codegen decidieron bifurcar Swagger Codegen para mantener una versión impulsada por la comunidad llamada OpenAPI Generator. Consulte las preguntas y respuestas para obtener más información.
Como arquitecto de plataforma y DevOps, puedo decir que lo introduje con éxito en un proyecto que utiliza la automatización de API de Dreamfactory, ya que BaaS y las API están definidas por swagger. Por lo tanto, los SDK para la aplicación móvil y las aplicaciones internas se generan con swagger-codegen. Encontramos algunos errores en la plantilla swagger-codegen para nuestros idiomas, que fueron bastante fáciles de solucionar. En general, ahorró mucho tiempo y reduce las posibles fuentes de error.
Lo usé para arrancar nuestra API basada en el codegen de primavera y ahora lo uso para cambiar y agregar los modelos de dominio y los puntos finales de la API. Todavía tienes que cambiar algunos aspectos de las clases generadas, pero hace que la refactorización sea muy sencilla y me impide acumular deudas técnicas. Es extremadamente útil tener el swagger-ui generado para las pruebas manuales y puede importar la especificación a Postman, que genera stubs para que tenga un buen punto de partida y una descripción general de TODO para escribir sus pruebas.
Sin embargo, todavía no he usado los SDK. Intenté usar los diversos clientes js pero no proporcionaron ninguna ventaja sobre las bibliotecas de recuperación simples.
Veo un gran potencial en codegen para frameworks js más complejos como Angular o React + Redux y también prueba de automatización.
Si guardas algún incógnita o disposición de acrecentar nuestro escrito te inspiramos añadir una crónica y con deseo lo ojearemos.