API Commons Is More Than Just The Definition, Specification or Schema
API Commons is about providing a simple and transparent mechanism for the copyright free sharing and collaborative design of API specifications, interfaces and data models. When learning about API Commons it can be easy to focus on the obvious technical deliverables of the project, API definitions, data models, schemas and specifications.
While API Commons is about providing a place to house these very technical design specifications, the largest benefit of API commons will be the process , community and culture that will form around it. Bringing API design across government and industries out into the open, focusing on sharing, collaboration, reuse and operability will be the true end product--not just the tangible API definition.
As I work on a handful of new API designs for various projects, that I plan on putting in the commons when ready, the importance of API Commons becomes ever clearer. While the end goal appears to be populating the commons with API designs, the real work is about bringing everyone out of the shadows, working on their API designs in a collaborative, re-usable way.
Laying the right foundation for this new API economy.