swagger-api/petstore-kafka

Questions from 'Boost Collaboration in Event-Driven Architecture with Development and QA Teams' Webinar

frankkilcommins opened this issue ยท 0 comments

๐Ÿ‘‹ This issue holds questions and answers from the webinar mentioned in the title

๐Ÿ“… Webinar recording March 29th, 2023
๐Ÿ“บ Webinar can be watched on demand here

Question 1: When do you recommend not to use EDA, any use case?

Recording has answer, Only use EDA when its needed, which often happens to either be for technical reasons (you need something in real-time) or scale reasons (you need to further decouple services).

Question 2: Some folks like to use Async REST API, instead of kafka events, they base on "kafka might go down", what you think about that?

Kafka is designed to be quite resilient, and each client often gets a list of brokers to attempt to connect to. REST vs Kafka's proprietary protocol doesn't make much difference in my subjective view, you can learn more about the producer properties here https://www.conduktor.io/kafka/kafka-producer-retries/

Question 3: If you 'Publish to SwaggerHub' from ReadyAPI does it change the Open API specification in SwaggerHub?

You will be able to create a new API definition based from ReadyAPI -> SwaggerHub via the "Publish to SwaggerHub" option. This isn't smart enough (yet) to update existing API definitions cleanly, but you could create a workflow to combine this with Compare And Merge feature to feed changes back into SwaggerHub. Links: https://support.smartbear.com/swaggerhub/docs/apis/compare-and-merge.html https://support.smartbear.com/readyapi/docs/apis/export.html. We do recommend making design changes in SwaggerHub rather than ReadyAPI (especially if adopting a design-first approach)

Question 4: Is SmartBear working with AsyncAPI to support code generation?

We're not directly working with open source, AsyncAPI Generator project, but are exploring ways to expand Swagger Codegen to be more general. If you have use-cases, we'd love to hear about them.

Question 5: What about code generation that generates Kafka Connectors?

The AsyncAPI Generator appears to support Java Spring Cloud Stream, which can be the basis for creating custom Kafka Connectors. https://www.asyncapi.com/tools/generator