API Resource, Capabilities, and Experiences
I am profiling APIs for APIs.io. I started with Twilio and Stripe, and working my way through many more. I am profiling their API operations using APIs.json, outlining their business approach to doing APIs, but I am also making sure the surface area of each API is profiled using an OpenAPI, profiling the technical dimension of each API. This work is tedious, but worth it. When you get the details of both the business and technical details of an API available in a machine-readable way, you end up with new found API discovery abilities to see which API providers are producing raw API resources, shaping our core digital capabilities, and which are contributing to more meaningful, or at least useful digital experiences.