Search for "api"

OpenAPI for Web Developers

Back with the PHP Community for the first time in a while at PHPUK! This talk is about OpenAPI specifically for backend developers, and covers some common scenarios that might be familiar to you, along with some suggestions for what … Continue reading →

From HTTP to OpenAPI with Optic

I’ve been using Optic’s CLI, an OpenAPI tool that does a bunch of things including diffing OpenAPI descriptions and comparing HTTP traffic with OpenAPI. My use case was an established API that didn’t have an OpenAPI file yet – using … Continue reading →

Preview OpenAPI as HTML using Scalar

The API DevTools space is alive and well with lots of new and exciting products popping up all the time. I’ve been especially impressed by the new tools in the docs space, but some of the options are less practical … Continue reading →

New OpenAPI Standards

Published an update of OpenAPI specification releases on TheNewStack OpenAPI Initiative: New Standards and a Peek at the Roadmap

OpenAPI Standards Landscape

Returning to the “all the APIs” track at FOSDEM with my talk “OpenAPI Landscape” covering the OpenAPI, Arazzo and Overlay releases from the last year. Video, slides and feedback links are here: https://fosdem.org/2025/schedule/event/fosdem-2025-5233-the-openapi-standards-landscape-a-year-of-innovation/

Querying the GitHub GraphQL API

In a recent project around open source contributors, I wanted to take a look at which projects a particular user (actually a few of them, but I wrote a wrapper to repeat the process for each handle) maintains. GitHub doesn’t … Continue reading →

Save edits to OpenAPI as an Overlay

For teams that generate OpenAPI from their codebase, there’s a tough choice between maintaining rich and extensive content such as Markdown descriptions and examples in codebase annotations, or in making those changes to the generated file – and then losing … Continue reading →

API Evangelist Conversation: API Experience

This episode of API Evangelist captures a chat about API experience and the role of extensions in expanding the OpenAPI specification’s features to fit specific needs or use cases. Also more chat about Overlays, of course! https://conversations.apievangelist.com/store/2024-12-12-lorna-mitchell/

API Evangelist Conversation: Overlays

Recorded another of my chats with Kin Lane, API Evangelist. This time we talked a bit about OpenAPI Overlays, and some of the common problems we both see in our various API projects and how Overlays can help! https://conversations.apievangelist.com/sessions/2024-12-05-lorna-mitchell.html

OpenAPI Overlays to avoid API oversharing

Use an OpenAPI Overlay (or Overlays) to remove deprecated, experimental or private endpoints from your OpenAPI description before publishing to different audiences. Continue reading →

LornaJane OpenAPI for Web Developers

Search Results for: api