Pinned Tweet
"most people who believe they work in API Design are actually working on technical API definition" brunopedro.com/2019/08/27/no…
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/…
I've been #writing about OpenAPI vendor extensions and ways to prevent collisions.
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?
This is the distribution of API operation categories after analyzing more than 50k OpenAPI documents from public GitHub repositories. I inferred a taxonomy by comparing the morphology of each API operation with a set of pre-established heuristics.
Bruno Pedro retweeted
"most people who believe they work in API Design are actually working on technical API definition" brunopedro.com/2019/08/27/no…
Now you can programmatically translate what your dog is trying to tell you! See this and other API-related news in this week's API Changelog newsletter: apichangelog.substack.com/p/…
"The most important thing about APIs is not their operations. At least, not for potential API consumers. The thing they value the most is understanding what capabilities an API offers."
apichangelog.substack.com/p/…
I'm experimenting with having my own MCP CIMD metadata file with my public keys and my client information on my brunopedro.com domain. Every time I want to connect to an MCP server that supports CIMD, I can use my own client information.
"Consumers can only use what they can understand. If an API is too complex, people steer away from it. If it’s too simple and it lacks depth, people can’t use it to fix their problems."
apichangelog.substack.com/p/…
"GhostLock can completely bypass detection because it doesn’t use any writes or encryption. Instead, it looks like a simple file indexer."
This and more at the API Changelog newsletter: apichangelog.substack.com/p/…
#security #network #dos
"The only reaction you receive from API consumers is through support when they complain. Face it, you have never received their feedback during the design stage. You simply have no idea how new consumers would feel when using your API."
apichangelog.substack.com/p/…
Bruno Pedro retweeted
Nice to see reShapr featured in the latest edition of @apichangelog.com by @bpedro 🚀
It’s an honor to get a shoutout alongside major updates from industry leaders!
🔗 Read the full issue here: apichangelog.substack.com/p/…
#APIs #AI #TechNews #MCP @AgenticAIFdn @linuxfoundation 🙌










