Material de la charla: "Diseñando API con OpenAPI 3.0.2" en @dotnetmalaga #openapi #dev #api #design #standards
A quien pueda interesar, abro experimento con el formato y dentro hilo:
-
-
5. OpenAPI propone un método estandarizado para definir APIs sobre HTTP (REST o no)
Show this thread -
6. El foco es la interoperabilidad entre fabricantes, frameworks y lenguajes perdurables en el tiempo. Fácil de decir, complejo de garantizar.
Show this thread -
España está bien representada en la OpenAPI Initiative por 3Scale, 42Crunch e ISA (Universidad de Sevilla)
Show this thread -
Isabelle Mauny
@isamauny CTO de@42crunch está trabajando desde Madrid en seguridad de APIs: criptografía y firma. Impulsando el estándar JOSE dentro de OpenAPI https://jose.readthedocs.io/en/latest/Show this thread -
El grupo ISA de Universidad de Sevilla http://www.isa.us.es/2.0/ trabaja en SLA (Service Level Agreement) aplicado a API. https://github.com/isa-group/SLA4OAI-Specification … Personalmente colaboro con ellos representándolos ante la OpenAPI Initiative.
Show this thread -
A partir de un contrato OpenAPI (en forma de JSON o YAML) puedes generar código proxy para cliente y skeletons para el lado servidor. Hay muchos lenguajes soportados. Todos los lenguajes "mainstream" están soportados. Y los que no, fork y te lo haces tú (the open source way...)
Show this thread -
Algunos casos de uso de OpenAPI en tus APIs (pasadas o futuras):
Show this thread -
A. API legada + contrato a mano (pasadas: ponle un contrato a una API existente)
Show this thread -
B. Contrato primero (servicio y cliente generados a partir del contrato)
Show this thread -
C. Servicio primero (contrato y proxy-cliente generados)
Show this thread -
Durante la demo mostré un contrato v2. http://bit.ly/gender-openapi2 sobre el servicio serverless de
@jerolba y su versión en sabor 3.0.2 http://bit.ly/gender-openapi3Show this thread -
Puedes usar la mejor herramienta para ver diferencias del mundo:
@semanticmerge para ver las pocas diferencias que tienen entre sí. ;-)Show this thread -
-
-
Prototipado: oas-generator (3.0) https://www.npmjs.com/package/oas-generator … oas-tools https://www.npmjs.com/package/oas-tools … swagger-tools (2.0) https://www.npmjs.com/package/swagger-tools … por
@whitlockjcShow this thread -
Conversion de contratos 2.0 a 3.0 (y validación) https://mermade.org.uk/openapi-converter … por
@PermittedSocShow this thread -
Generadores: 1. https://swagger.io/tools/swagger-codegen/ … 2. https://openapi.tools/ 3.https://github.com/OpenAPITools/openapi-generator …
Show this thread -
Si necesitas estandarizar tu API, tarde o temprano tendrás que tomar decisiones de diseño. Aquí tienes algunas: Recomendaciones de Adidas https://adidas.gitbook.io/api-guidelines CAL:https://github.com/metadevpro/cal
Show this thread -
En Holanda han estandarizado OpenAPI 3.0 para obligar a su uso en todas las API que publiquen las administraciones públicas. https://www.linkedin.com/pulse/why-dutch-government-standardised-openapi-3x-dimitri-van-hees/ … por
@dvhShow this thread -
Pensad en las implicaciones que tiene esto para OpenData y la transformación digital de un país.
Show this thread -
En la Unión Europea y en España se mira atentamente al caso holandés y hay interés por estandarizar también. Ojo a lo que viene... nadie quiere quedarse atrás.
Show this thread -
-
-
2. OpenAPI, estandarizando los contratos de las APIhttps://www.genbeta.com/desarrollo/openapi-estandarizando-contratos-api-entrevista-a-pedro-j-molina …
Show this thread -
3. Three common scenarios for leveraging the OpenAPI Specificationhttps://www.openapis.org/blog/2017/09/26/three-common-scenarios-for-leveraging-the-openapi-specification …
Show this thread -
-
Mucho ánimo a todos los aguerridos compañeros que luchan en las profundidades contra los innumerables tentáculos del monstruo del backend.pic.twitter.com/B8OtICxQnn
Show this thread -
Espero que os haya gustado el hilo a los que no pudisteis seguirlo en vivo en
@dotnetmalagaShow this thread
End of conversation
New conversation -
Loading seems to be taking a while.
Twitter may be over capacity or experiencing a momentary hiccup. Try again or visit Twitter Status for more information.