Re:What Drop-In API Observability Looks Like, Pre-Launch and...
by kgilpin on Friday July 01, 2022 @12:47PM
(#31949159)
Hi, I’m creator of a tool called AppMap that will record traces of your code (test cases or live interaction). Once you’ve made AppMaps there are different tools you use on top of it, such as visualization and analysis, and extensions for VSCode and JetBrains.
One of the tools is openapi generation. Here’s a blog post that shows how it works: https://appland.com/blog/2021/12/22/how-to-auto-generate-ope...
AppMap works with Rails, Django, Java, and JS/Express. Check it out and let us know what you think!
Re:What Drop-In API Observability Looks Like, Pre-Launch and...
by jeanyang on Tuesday July 05, 2022 @10:50PM
(#31996178)
Hi, Jean here from Akita. Yes, it's possible to generate an OpenAPI spec, either by running Akita in production or from a HAR file. Here's a blog post someone wrote about using Akita to generate an OpenAPI spec: https://apisyouwonthate.com/blog/creating-openapi-from-http-...
Re:What Drop-In API Observability Looks Like, Pre-Launch and...
by ndimares on Friday July 01, 2022 @02:56PM
(#31951062)
I see a lot of value in being able to generate the schema based off of real time traffic, vs. static analysis or test cases. In my mind the traffic to the API is the real source of truth for the API.
Interesting... could be cool to see a value-add service on top of Akita or another Obs vendor that just inspects req/res payloads and generates OpenAPI specs based off what was observed. I can't count how many times I've dropped into teams and tried to piece together their API contracts just to realize... they don't have specs! Having to then turn around and reconstruct them backwards based off code spelunking and maybe some design docs is... frustrating.