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.
Phil Sturgeon
Co-founder of APIs You Won't Hate, consultant/writer on all things API, working on green/climate tech, and restoring nautral habitats as co-founder of @ProtectEarthUK.
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
api-design
Make Your API Idempotent, Avoid Ruining Clients Lives
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
Modern OpenAPI Tooling for the entire API Lifecycle
Step into the future of API tooling with this video Phil Sturgeon recorded for Treblle's Hacktoberfest called "Modern OpenAPI Tooling."
Should an API use Semantic Versioning?
Recently I was talking with the Trebble team on a "X Space" they were hosting all about API versioning, and one topic came up which I wanted to delve into further: Semantic Versioning for API Versions.
codegen
Generate a TypeScript REST API client with Fern
Generate TypeScript client code easily with Fern, an automated tool that builds SDKs for major languages, Postman Collections, and OpenAPI definitions. Avoid the slow and brittle manual process, and publish directly to package repositories like NPM.
api-design
How to Capture Quite a Lot of API Traffic
When rewriting an API, it's critical to make sure you don't change the shape of your inputs and outputs unexpectedly. After all, API specs are called contracts for a reason. This article outlines an approach to capturing API traffic using Optic for just this purpose.
APIMatic Review: Developer Experience-as-a-Service
This article is sponsored by APIMatic, in that they're paying for our time to review their product, but they're not paying for what we write. If it's rubbish, we'll let you know. I've used APIMatic a fair bit in the
openapi
Turn HTTP Traffic into OpenAPI with Optic
Capture real HTTP traffic from production or anywhere else, and create OpenAPI from it, for documentation, mocks, SDKs, or contract testing.