API Standards for AI Agents
Had a GREAT chat with some leading lights in the API space, thanks to Nordic APIs! Video: https://youtu.be/gJNQPhvS2NI
Search Results for: api
Tag Kinds in OpenAPI 3.2
OpenAPI tags have always been annoying: user-supplied arbitrary data for endpoints should be a fabulous feature – but the documentation tools seem to think that tags are only for them so it becomes more difficult to use tags for other … Continue reading
Nested tags in OpenAPI 3.2
OpenAPI has always had support for simple tags, but the OpenAPI 3.2 release brought in some serious tag upgrades including a summary field, a “kind” field with registry, – and the ability to nest tags which is the focus of … Continue reading
What’s new in OpenAPI 3.2
It is always a joy to mix with the API community! This year we launched OpenAPI 3.2 at APIDays London; here are the slides from that talk – or you can refer to the [release notes](https://github.com/OAI/OpenAPI-Specification/releases/tag/3.2.0). View What’s new in … Continue reading
Quick local API docs with Scalar
Today I’m sharing a quick-and-dirty script to take an OpenAPI description, spin up a docs server locally, and copy the URL into your clipboard. I also use a bit of glob expansion in my script to find the right folder, … Continue reading
API Specificity with Overlays and Enums
The more I work on API standards, the more I realise how few teams understand that they can adopt the standards and, without breaking any contract, adapt them to make a strong interface for their own application. One of my … Continue reading
OpenAPI: How to handle file management
My latest post on TheNewStack is about how to handle those large OpenAPI files without losing your mind: https://thenewstack.io/openapi-how-to-handle-file-management/
Right-Size Your RESTful API: More Flexibility Without GraphQL
Change the fields returned by your API by offering more representations of the resources. This under-appreciated feature of API design can help teams to get the best from their API for multiple use cases, without the need to switch to GraphQL. Continue reading
Markdown/Mermaid output for OpenAPI Arazzo
API reference documentation changed the way we built integrations, and eventually became part of the driving force for OpenAPI adoption and all the good tooling that flowed from it. As a developer experience specialist, I spend a lot of time … Continue reading
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