openapi
How to use JSONPath with OpenAPI
JSONPath is a query language that can be used to extract data from JSON documents, and it's becoming increasingly useful in the OpenAPI ecosystem.
Phil Sturgeon
Co-founder of APIs You Won't Hate, and part techie, part woodland creation, and ancient woodland restoration. Co-founder of @ProtectEarthUK. @philsturgeon@mastodon.green
openapi
OpenAPI v4.0 (A.K.A "Project Moonwalk")
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?
api-design
API Code-first: How to Generate OpenAPI from Code
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.
openapi
Use OpenAPI Overlays Today
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?
api-design
How to Build a Perfect API Description
Learn what best practices and tooling you can use to build the best quality OpenAPI documentation from somebody who has been doing it forever.
api-design
Battle of the API Ratings: API Insights vs Rate my API
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.
Low Code & No Code API Solutions - Are they Right for You?
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
Utilize AI for API Governance with LintGPT
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.
Low Code, No Code, and Automation for APIs - Gimmick or Godsend?
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
OpenAPI & AsyncAPI $ref: Advanced Guide
Master the use of $ref in OpenAPI and AsyncAPI to manage complex YAML/JSON documents, reduce merge conflicts, and streamline your API descriptions.
Popular OpenAPI Bundling Tools Compared
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
Meet Redocly CLI: The Modern OpenAPI Sidekick
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