To empower developers to consume Web APIs to fulfill the use-cases they care about.
A Coruña, Spain
Joined December 2006
- Tweets11.2K
- Following0
- Followers6.7K
- Likes1.8K
Pinned Tweet
"most people who believe they work in API Design are actually working on technical API definition" brunopedro.com/2019/08/27/no…
User journeys usually start with one or more requests to a REST API followed by events.
You think in terms of capabilities, not protocols.
Why do we document synchronous and event-driven APIs separately?
apichangelog.substack.com/p/…
What is the unit of value in APIs?
If you were to create an API marketplace, what would you target as the unit of value?
Ultimately, consumers want the capabilities provided by the APIs, not the APIs themselves.
notes.brunopedro.com/2023/06…
Are you using swagger-ui to render your OpenAPI description?
You might be interested in something I've been building that shows API diffs inline: github.com/InditexTech/swagg…
Reading isn’t enough when you want to learn something new.
To actually learn how to do something, you need to try it. Perhaps you’ll fail a few times, but that’s all part of the learning process.
apichangelog.substack.com/p/…
Sooner or later, every change you introduce to your API will break the integration with at least one consumer.
The interface stops being the interface. Hyrum goes further and says the "interface has evaporated."
apichangelog.substack.com/p/…
I can see this flow for AI-enabled Product Development producing great results:
User Interviews → Problem Discovery → User Story Distillation → SDD → Verification against Acceptance Criteria → Delivery
The challenge with agentic workflows and stateless APIs is related to the need to handle user input as a response to a request.
The solution seems to be doing “multi round-trip requests” using something called InputRequiredResult.
apichangelog.substack.com/p/…
Should agents generate integration code once or let AI figure out how to consume APIs whenever they need to?
These two choices are, in fact, a false dichotomy.
apichangelog.substack.com/p/…
Creating a new OpenAPI extension is as easy as starting a property name with the x- string.
But what happens when two or more extensions pick the same property name?
apichangelog.substack.com/p/…
Is feature A sending a command to feature D, or is it simply sharing information about something that happened?
brunopedro.com/2022/10/19/ev…
More than half of large companies now manage more than 1,000 APIs.
If each API has, on average, 10 operations, you end up with an inventory that is almost impossible to manage.
apichangelog.substack.com/p/…
What is the relationship between API Governance and quality?
The best approach to managing API Governance is not to ask people to follow rules blindly. Instead, it’s better to start from the end goal of having the best possible API quality.
brunopedro.com/2024/05/25/ap…
"The OpenAPI Overlay Specification provides a structured way to apply changes to an OpenAPI document without touching the original file."
openapispec.com/docs/how/how…
"Other than yourself, the developers from your team, and a couple of customers, no one really used your API. When you ask your team why there’s no usage, they can’t explain it."
apichangelog.substack.com/p/…
I've been working on a Swagger UI plugin that highlights API changes inline.
Instead of having to open a report with all the changes, you can see them while browsing the documentation.
github.com/InditexTech/swagg…
"Every API product starts with an idea," I wrote in the book Building an API Product, in 2024.
How do you navigate the ideas that help you create API products?
