What is coming next for OpenAPI, as v4.0 of the OpenAPI Specification gets closer to being released? What major changes are coming, how easy will it be to upgrade, and how do tooling companies feel about it? Recent History of OpenAPI OpenAPI has been around for a long time, but only hit the mainstream when OpenAPI v3.0 was released in 2017. It made it a whole lot easier to describe the majority of REST/RESTish APIs, and brought in major investment from tooling developers big and small who jumped at the chance to add value to the community. OpenAPI v3.1 came out in early 2021, and focused on fi ..read more

We've posted about API Code-first vs API Design-first a fair few times over the years, but this article aims to be an updated look at some of the current day tooling which makes both workflows nicer to handle. ? Thank you to Bump.sh for sponsoring this post, and giving me time to write down some updated thoughts on this topic. API Code-first is the art of building an API and then popping some annotations or metadata in there to pop out API documentation in a API description format like OpenAPI. Is that how you want to keep doing things? Maybe, there's some tooling out that's made it a lot e ..read more

It's been a while since OpenAPI v3.1 came out, an Project Moonwalk (OAS v4.0) is still in discussion and design phase, but that doesn't mean there's nothing new in the world of OpenAPI. Overlays are one of the OpenAPI Initiatives newest offerings, and I've already been using them to solve problems. Overlays are a way to "patch" an OpenAPI document, by pointing to a specific part of it with a JSONPath, then using "actions" to update or remove parts of the document. Why would anyone want to do this? Technical Writers Perhaps you're a technical writer trying to improve the OpenAPI-based document ..read more

Show notes Skyvern https://www.skyvern.com/ Skyvern is Open Source! https://github.com/Skyvern-AI/skyvern Launch on Y Combinator's site: https://www.ycombinator.com/companies/skyvern Suchintan Singh (YC S23) on LinkedIn Transcript [00:00:00] Mike Bifulco: Hello and welcome back to APIs you won't hate. My name is Mike Bifulco. And today I'm sitting down for a conversation with a friend of mine from actually last summer, which I guess we'll get into in, in a little while here. But talking a little bit about Sky Verne with Ton Singh from the founding team of Sky Verson. How are you ..read more

Show Notes Zeno's flash->javascript demo with HTML5, Wormz https://zenorocha.github.io/wormz/ Zeno Rocha @ZenoRocha on Twitter @zenorocha on Threads  Dracula theme React email Resend.com Resend Forward Broadcasts - marketing emails Batch email sending - send 100 emails with one API call Transcript Support APIs You Won't Hate When you become an member, you'll get access to members-only content while directly supporting our work. Your support helps us to keep making resources for the API community. Become a member today ..read more

My day job is all things backend development; well, mostly. I also love all things frontend. React, Vite and Remix have become my go-to tools for building websites and web apps. That's right, I love JavaScript, and I won't stop pushing it till we all embrace the one true language and use nothing else ??. Anyway, jokes aside, we can agree on the importance of the API Design First approach. Can we reuse this effort that we are putting into our OpenAPI spec? Well, you're in luck. I have put some great tools together to help generate queries, hooks, validations, and more in your front end with yo ..read more

Show Notes Quobix - Dave Shanley's site. Code is art daveshanley/vacuum on GitHub - the world's fastest OpenAPI 3, OpenAPI 2 / Swagger linter wework/speccy on GitHub - Well Spectually ? Enforce quality rules on your OpenAPI 3.0.x specifications. Wire⚡️Tap - is the world’s coolest OpenAPI compliance and testing tool, from Quobix Battle of the API Ratings from APIs You Won't Hate - Dive into a detailed comparison of Trebble's API Insights and Zuplo's Rate my API, exploring their unique approaches to evaluating API design, performance, and security Openapi.tools - an Open Source and community-d ..read more

You're starting out describing your API with OpenAPI, you've read the OpenAPI Documentation, you've even read the OpenAPI Specification, now you want to make sure you're doing it well. How can you know? There's a few quick bits of advice to start with. Use YAML over JSON for your OpenAPI. Nobody wants to mess with brackets. Convert it automatically somewhere in your pipeline if you need JSON for a specific tool. Name your main file openapi.yaml. This is recommended by the OpenAPI Specification, and using .yml will cause confusion over and over for years. Use OpenAPI v3.1.0. It's the best vers ..read more

AWS released their new JS runtime called LLRT. Faced with a new level of JavaScript fatigue, not just frameworks but different runtimes that are all different, I decided to learn PHP ?. I jest a little; we seem to be coming full circle with adopting standards; check out the WinterCG group, so working with these new runtimes should be easy ?. In the last two weeks, I have spent far too much time getting OpenAPI generation to work on a Kotlin project. However, it inspired me to look into some of the most popular OpenAPI tools in some of the best web frameworks. Here is what I found. -- Alexande ..read more

Show Notes Allan Knabe Apiable - Every API is a business Careers at Apiable Pirate Weather Transcript [00:00:00] **Track 1:** Hi friends, and welcome back to APIs you won't hate. My name is Mike Biko. I'm one of the co-founders of APIs you won't hate. And of course, podcast co-host and occasional friend of Phil's. We get to catch up and talk about API stuff when I can find him wherever he is in the world. But today I'm excited to sit down and chat with a new friend of mine. [00:00:19] I'm here talking to Alan Kaba about what he's building with API bull. And really excited to hear you ..read more