Machine Readable API Regions for Use at Discovery and Runtime
I wrote about Werner Vogel of Amazon’s post considering the impact of cloud regions a couple weeks back. I feel that his post captured an aspect of doing business in the cloud that isn’t discussed enough, and one that will continue to drive not just the business of APIs, but also increasingly the politics of APIs. Amidst increasing digital nationalism, and growing regulation of not just the pipes, but also platforms, understanding where your APIs are operating, and what networks you are using will become very important to doing business at a global scale.
It is an area I’m adding to my list of machine-readable API definitions I’d like to add to the APIs.json stack. The goal with APIs.json is to provide a single index where we can link to all the essential building blocks of an API’s operations, with OpenAPI being the first URI, which provides a machine-readable definition of the surface area of the APIs. Shortly after establishing the APIs.json specification, we also created API Commons, which is designed to be a machine-readable specification for describing the licensing applied to an API, in response to the Oracle v Google API copyright case. Beyond that, there haven’t been many other machine-readable resources, beyond some existing API driven solutions used as part of API operations like GitHub and Twitter. There are other API definitions like Postman Collections and API Blueprint that I reference, but they are in the same silo as OpenAPI operates within. https://goo.gl/tcbk7F #DataIntegration #ML
How to Sync Your OpenAPI Schema in Stoplight With GitHub and Runscope
ICYDK: This is a post from our Featured Guest Series! Glen Semino shows how to combine Stoplight and GitHub APIs with Runscope to keep your OpenAPI Schema always versioned and up to date.
About a month ago, after I and part of the SYNQ team attended the APIDays SF conference, we reflected on what we had learned at the conference. One of the things we realized was that our API spec documentation needed quite a bit of improvement. And among the tools discussed in the conference was Stoplight, which helps one design, document, mock, and debug APIs. https://goo.gl/VgxrSA #DataIntegration #ML
