SOA Software Director of API Strategy, Laura Heritage, discusses new ways to describe and document APIs have emerged such as Swagger, RAML, API Blueprint and others, each taking a slightly different approach. Please join us in this webinar to hear how these description languages differ and how to choose right one for your API.
Blueprint - It allows you to draw out what the potential API version can and should look like when it is completed.
Contract – It becomes the agreed upon contract between the consumer and provider
Metadata - houses the metadata which can be used in machine to machine communication or system to system interactions, primed for IoT
Instruction Manual - Human readable documentation is produced to all people to understand how to use the API
Sharable -- Not description languages was one of the largest barriers to adoption in an enterprise. No easy way to share internally
Readable - relatively non-technical person can read it
Governable – Enterprises like it or not need governance, with the lack of a way to describe a RESTful API there wasn’t a good way to put governance around it