OpenAPI 4: Project Moonwalk
Learn about Version 4.0 of OpenAPI, nicknamed "Project Moonwalk", which is set for a 2024 release. Catch news about HTMX, API Docs, Cloudflare Go, and Bruno, an API client that works with Git.
Learn about Version 4.0 of OpenAPI, nicknamed "Project Moonwalk", which is set for a 2024 release. Catch news about HTMX, API Docs, Cloudflare Go, and Bruno, an API client that works with Git.
What is coming next for OpenAPI, as v4.0 of the OpenAPI Specification gets closer to being released? What changes are coming, how easy will it be to upgrade, and how do tooling companies feel about it?
An update on the API Code first or Design first debate, with some modern tools making a slightly nicer version of the Code first workflow, and better modern design first tooling.
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. Can this help you?
Suchintan Singh, founder of Skyvern (Y Combinator S23) stops by to chat about using LLMs and AI Agents to automate workflows in the cloud. Skyvern's approach to building a business follows a classic startup path: find painful, boring tasks, and automate them!
We've been working on a rebuild of our popular Open Source project, openapi.tools. Get an inside look at what's coming, as well as API news about Webflow, Laravel, Spectral OWASP, Deno, and OpenAPI AutoSpec.
Robin Guldener from Nango talks to Mike about building an open, unified API, the value of building on top of Open Source products, and building a growing product team on this episode of the podcast.
We bid the Pet Store API example a fond farewell, and look to a new future with the newly released Train Travel API. Also this week: laravel, express, and the terminal UI for OpenAPI!
Zeno Rocha from Resend shares the story of his Y Combinator backed company, and what it's like to build great open source tools, focused & minimal APIs, and a great engineering team.
Explore frontend tools that can be used to build and implement interfaces for design-first APIs, like Orval, Quicktype, OpenAPI Qraft, and Kubb.
Phil has a chat with Quobix about his tools for API linting, testing, and compliance. We hear the story behind Open Source tools Vacuum and Wiretap, and Quobix's journey building highly performant devtools with golang.
Learn what best practices and tooling you can use to build the best quality OpenAPI documentation from somebody who has been doing it forever.
In this issue of the newsletter, we share some of the many available pairings of brilliant OpenAPI tools and web frameworks. From Kotlin to Python, Hono & Zod to Fastify, there's great OpenAPI plugins all around.
Apiable is building an API Portal service that helps API teams to create, secure, market, and monetize API products. In this episode of the podcast, Apiable founder Allan Knabe has a chat with Mike Bifulco about building a great api product.
There are many environmentally friendly options available to developers building APIs. Taking small steps to make your code more environmentally can make a big difference. Hop in to learn about some climate-friendly options for tooling.
Phil sits down with Lorna Jane Mitchell to get the latest on what's going on at Redocly, the state of OpenAPI 3.1, and what's to come with OpenAPI's proposed 4.0 spec, Moonwalk.
api-design
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. Learn how these tools can elevate your API governance and design, ensuring a robust, efficient, and secure API experience.
Explore the practicality and trade-offs of no/low code APIs, including tooling and categories, for efficient API development, including: Strapi, Contentful, Sanity, AWS Amplify, DreamFactory, Firebase, Airtable, Zapier, Make, and Pipedream.
openapi
LintGPT from Optic is the latest way to automate your API Style Guides, combining API Linting with ChatGPT in a way that's not just buzzword nonsense.
Explore the balance between traditional API design and innovative low/no-code solutions in API development. Uncover insights from an expert's journey, highlighting the practicality and trade-offs of these approaches. Perfect for API developers and tech enthusiasts.
openapi
Master the use of $ref in OpenAPI and AsyncAPI to manage complex YAML/JSON documents, reduce merge conflicts, and streamline your API descriptions.
When OpenAPI or JSON Schema documents get massive or repetitive, the contents can be split across multiple documents (on the filesystem, URLs, in memory somewhere) and joined together $ref. These split up API descriptions can then be joined back together as one document, with $ref pointing to an internal location
Redocly CLI is a brilliant new tool from the folks who made ReDoc, the first beautiful API reference documentation tool powered by OpenAPI. This CLI tool goes a lot further than documentation, and helps with “linting” (automated API Style Guides), and solves the biggest problem that I had previously been
api-design
Explore idempotency in HTTP, highlighting its importance in preventing unintended effects of repeated actions. Learn how methods like GET, PUT, and DELETE inherently support idempotency, ensuring consistent results.
api-design
Step into the future of API tooling with this video Phil Sturgeon recorded for Treblle's Hacktoberfest called "Modern OpenAPI Tooling."