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."
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
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.
Securing APIs with the Spectral OWASP Ruleset
Recently I've been on a run of making new all powerful Spectral rulesets, but so far it's been focused on the concept of automating style guides, with the concrete example of the APIs You Won't Hate: API Style Guide showing how it can be
🎙️ APIs You Won't Hate (The Podcast)
Don't roll your own API Management tools, with Josh Twist from Zuplo
Our guest this episode is Josh Twist, CEO and Co-founder of Zuplo. We chat about Zuplo's history, their developer products and audience, and the complexities of maintaining APIs in small and large companies.
Testing Spectral Style Guides with Jest
Readers of this blog will be familiar with the concept of Automating API style guides implemented with programable API linters like Spectral. When combined with the power of API Design-First, these API style guides can power the core of your API design reviews, improving consistency and reducing the frequency of
Distribute Spectral Style Guides with NPM
At some point in the growth of an organization there will come a time where you've got too many different APIs with random different data formats, naming conventions, security schemes, and generally it feels bizarre and frustrating trying to call any API because you cannot share any code
Contract Testing a Laravel API with OpenAPI
Your API does a bunch of great stuff, and your OpenAPI document tells everyone about all the great stuff that your API can do, but making sure those two sources of truth agree can be a bit of a struggle at first. Whether you followed the API design-first workflow and
Creating OpenAPI from HTTP Traffic
Around this time of year we're thinking about things we're going to do differently, new practices we've been putting off for too long, and mistakes we want to avoid continuing into another year. For many of us in the API world, that is going