Open in app
Sign inGet started
Low Code, No Code, and Automation for APIs — Gimmick or Godsend?

Low Code, No Code, and Automation for APIs — Gimmick or Godsend?

Designing an API using OpenAPI and going through modeling, mocking, etc. can save you wasting a bunch of time building the wrong thing, and…
Go to the profile of Phil Sturgeon
Phil Sturgeon
A brief introduction to OpenAPI

A brief introduction to OpenAPI

It’s hard to work on APIs without hearing about OpenAPI, but what is it all about? This introduciton will get you from zero to hero.
Go to the profile of Phil Sturgeon
Phil Sturgeon
OpenAPI & AsyncAPI $ref: Advanced Guide (Sponsored by Bump.sh)

OpenAPI & AsyncAPI $ref: Advanced Guide (Sponsored by Bump.sh)

After using OpenAPI or AsyncAPI for a while, you might notice your description documents have become a rather unwieldy mess of YAML and…
Go to the profile of Phil Sturgeon
Phil Sturgeon
Working with the new Idempotency Keys RFC (Sponsored by HTTP Toolkit)

Working with the new Idempotency Keys RFC (Sponsored by HTTP Toolkit)

Idempotency is when doing an operation multiple times is guaranteed to have the same effect as doing it just once.
Go to the profile of Phil Sturgeon
Phil Sturgeon
Latest
What is OpenAPI v4.0: Project Moonwalk (Sponsored by Bump.sh)

What is OpenAPI v4.0: Project Moonwalk (Sponsored by Bump.sh)

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…
Go to the profile of Phil Sturgeon
Phil Sturgeon

Using OpenAPI to simplify building and testing Laravel APIs

Learn how to combine the power of the API Design-First workflow with OpenAPI tooling which massively simplify your Laravel code and tests.
Go to the profile of Phil Sturgeon
Phil Sturgeon

Generating OpenAPI docs for Ruby on Rails with RSwag

API Code-first is the art of building an API, and then popping some annotations or metadata in there to output API documentation in an API…
Go to the profile of Phil Sturgeon
Phil Sturgeon

Using OpenAPI to simplify building and testing Ruby on Rails APIs

Following the API Design-first approach with RoR API, leverage OpenAPI to handle request validation and contract testing.
Go to the profile of Phil Sturgeon
Phil Sturgeon
Battle of the API Ratings: API Insights vs Rate my API

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…
Go to the profile of Phil Sturgeon
Phil Sturgeon
Low Code & No Code API Solutions — Are they Right for You?

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…
Go to the profile of Phil Sturgeon
Phil Sturgeon
Utilize AI for API Governance with LintGPT

Utilize AI for API Governance with LintGPT

LintGPT from Optic is the latest way to automate your API Style Guides, combinging API Linting with ChatGPT.
Go to the profile of Phil Sturgeon
Phil Sturgeon

Code-first: How to Generate OpenAPI from Code

API Code-first is the art of building an API, then finding ways to produce OpenAPI for docs/SDKs/etc. later. Will these tools work for you?
Go to the profile of Phil Sturgeon
Phil Sturgeon
Popular OpenAPI Bundling Tools Compared

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…
Go to the profile of Phil Sturgeon
Phil Sturgeon
Contract Testing a Laravel API with OpenAPI | APIs You Won’t Hate

Contract Testing a Laravel API with OpenAPI | APIs You Won’t Hate

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…
Go to the profile of Phil Sturgeon
Phil Sturgeon
Creating OpenAPI from HTTP Traffic

Creating OpenAPI from HTTP Traffic

More organizations are switching to API Design-first with OpenAPI, thanks to huge efforts from tooling vendors — from the bigger folks…
Go to the profile of Phil Sturgeon
Phil Sturgeon
There’s No Reason to Write OpenAPI By Hand

There’s No Reason to Write OpenAPI By Hand

Some API developers use API descriptions to plan the interface of an API before building it, which is known as the “API design first”…
Go to the profile of Phil Sturgeon
Phil Sturgeon
There’s No Reason to Write OpenAPI By Hand

There’s No Reason to Write OpenAPI By Hand

Some API developers use API descriptions to plan the interface of an API before building it, which is known as the “API design first”…
Go to the profile of Phil Sturgeon
Phil Sturgeon
OpenAPI v3.1 and JSON Schema 2019–09

OpenAPI v3.1 and JSON Schema 2019–09

OpenAPI using an “extended subset” of JSON Schema has caused confusion forever, but it has been resolved for OpenAPI v3.1!
Go to the profile of Phil Sturgeon
Phil Sturgeon
Automated Style Guides for REST, GraphQL and gRPC

Automated Style Guides for REST, GraphQL and gRPC

Ask 100 developers where a semicolon should go, and you’ll either get 100 answers, or a all-on-all fist fight. To save this from happening…
Go to the profile of Phil Sturgeon
Phil Sturgeon
OpenAPI Callbacks and Webhooks

OpenAPI Callbacks and Webhooks

OpenAPI is thoroughly mainstream now with most modern API providers producing a description of their API for both internal and external…
Go to the profile of Phil Sturgeon
Phil Sturgeon
API Design-First vs Code First

API Design-First vs Code First

Should you do “API Design-first” or “code-first”, and what do these things even mean?
Go to the profile of Phil Sturgeon
Phil Sturgeon
Update on OpenAPI and JSON Schema

Update on OpenAPI and JSON Schema

The API design space is booming right now, with OpenAPI and JSON Schema tooling seriously growing up. My new job at Stoplight.io is…
Go to the profile of Phil Sturgeon
Phil Sturgeon
Server-Side Validation with API Descriptions

Server-Side Validation with API Descriptions

Are you treating code and API descriptions as two separate things which need to be kept in sync? Now you can stop doing that.
Go to the profile of Phil Sturgeon
Phil Sturgeon
REST and Hypermedia in 2019

REST and Hypermedia in 2019

Nobody out there thinks you should always use REST for every single API being built, but you should definitely use it for some.
Go to the profile of Phil Sturgeon
Phil Sturgeon
Useful API Errors for REST, GraphQL and gRPC

Useful API Errors for REST, GraphQL and gRPC

Dealing with the Happy Path™ in an API is pretty easy, but creating useful error messages can be tricky at first.
Go to the profile of Phil Sturgeon
Phil Sturgeon
Resolving Overloaded Terms for API Specifications… Descriptions… Contracts?

Resolving Overloaded Terms for API Specifications… Descriptions… Contracts?

Specifications, Descriptions, Documents, Spec Files, Contracts, ugh… they’re the same thing!
Go to the profile of Phil Sturgeon
Phil Sturgeon
Caching is hard, draw me a picture–Updated

Caching is hard, draw me a picture–Updated

Another guest post from our friend Darrel Miller, this time explaining caching.
Go to the profile of Phil Sturgeon
Phil Sturgeon

An OAuth2 middleware for fetch()

I was a bit frustrated with the existing offerings for OAuth2 clients in Javascript. I heavily use the Fetch API directly, but Web API’s…
Go to the profile of Evert Pot
Evert Pot
About APIs You Won't HateLatest StoriesArchiveAbout MediumTermsPrivacyTeams