News for hackers. Stuff that matters.
Re:AsyncAPI vs. OpenAPI: Answers to Your Burning Questions by SideburnsOfDoom on Thursday September 09, 2021 @01:08PM (#28471979)
> Is there a benefit to describing APIs using YAML

"describing HTTP APIs using YAML" (or JSON) is OpenApi/Swagger.

AsyncAPI appears to be the "OpenApi, but for message queues" (and similar async communication mechanisms).

> Basically all you can do is generate HTML docs from YAML.

With OpenApi, you can generate interactive docs, where you can build and execute requests against a real API (not in prod, we hope)

You can generate code off OpenApi (and not just python and Java*). Anything from just DTOs to full clients. You can generate stub servers. You can inspect server code and flag up where it differs from the spec. You can test your API.

Re:AsyncAPI vs. OpenAPI: Answers to Your Burning Questions by BerislavLopac on Friday September 10, 2021 @03:47AM (#28478810)
Re:AsyncAPI vs. OpenAPI: Answers to Your Burning Questions by woile on Friday September 10, 2021 @05:44AM (#28479433)
This looks quite good. If I understand correctly the idea is:

- create openapi file - write only functions

If so, it's super nice

Re:AsyncAPI vs. OpenAPI: Answers to Your Burning Questions by BerislavLopac on Friday September 10, 2021 @06:56AM (#28479831)
Thank you - that's exactly the idea. There is also a client version which automates calling the API's operations.