keshav vasudevan

Announcing OpenAPI Specification 3.0 Support for Building Great APIs

September 21, 2017 By keshav vasudevan

It’s quite fascinating to see the evolution of a small, renegade open source project change the perception of an entire industry.

This is what happened with the Swagger Specification, the open source API design standard that went on to develop an entire community of developers, a powerful ecosystem of tools around it, and eventually evolve to become the OpenAPI Specification (OAS), the world’s standard for defining RESTful services. Being the company and team behind the initial versions of the Swagger Specification, it’s been a privilege to be a part of this innovation.

Today, we are pleased to announce support for the next version of the OpenAPI Specification, 3.0 in SwaggerHub. [Read more…]

API Business Models for the Modern API Economy

August 17, 2017 By keshav vasudevan

Back in January, Forbes contributor Louis Columbus predicted that 2017 would be “The Year of the API Economy”.

When you look at the investments being made into APIs, this reality is hard to ignore. There are big investments made by organizations into APIs, be it internal or external APIs, and upper management will face pressure to come up with new and innovative business models around the digital API economy. APIs are increasingly being explored to address top strategic priorities like business agility and customer growth.

Today, it is estimated that the number of public APIs is over 50,000. Programmable Web lists over 17,000 public APIs in its database. This does not include the thousands of privately managed internal APIs, which continue to gain adoption across major industries around the globe. According to SmartBear’s 2016 State of API Report, 1 in 5 API providers only began developing APIs within the last five years alone.

API adoption is only set to increase with the exponential rise in the number of connected devices. The IoT revolution is also upon us, with home devices, bots, and wearable devices all contributing to our growing desire to stay connected. By 2020, it is estimated that every person in the world will have seven devices, on average. [Read more…]

Introducing the New SwaggerHub Apigee Integration

July 26, 2017 By keshav vasudevan

As organizations invest more in the API economy, there’s a big realization on how difficult it can be to ensure success in their API programs. With more devices getting added to the multi-platform ecosystem, and consumers of varying skill level starting to adopt APIs, there is a definite need for policies and management to ensure program find success.

There are numerous platforms, both cloud based and on-premise, that allow organizations to abstract their management layer. Apigee, from Google, has emerged as one of the leading players in the API management space, commanding an impressive suite of features, and a large and loyal customer base.

With the growing demand for integrating the API design and documentation process into Apigee, SwaggerHub is proud to introduce a direct integration with Apigee Edge, a platform for managing API proxies. [Read more…]

How Bonotel Improved Collaboration and Accelerated API Delivery By Switching to SwaggerHub

July 17, 2017 By keshav vasudevan

In such a distributed infrastructure, there are a lot of APIs integrating various components together. Bonotel uses the Swagger (OpenAPI) specification to define these different services. At the beginning of their Swagger journey, the teams utilized the open source Swagger tooling for designing, building and documenting RESTful APIs. But they soon faced challenges when it came time to scale their API development across their internal and external teams. [Read more…]

Best Practices in API Documentation

June 20, 2017 By keshav vasudevan

APIs are only as good as their documentation. A great API can be rendered useless if people don’t know how to use it, which is why documentation can be crucial for success in the API economy. But creating and maintaining good documentation that’s easy to read, enjoyable to interact with, and sets the consumer up for success can be extremely challenging.

Creating great documentation requires effort and patience, but it has direct implications on API adoption and maintainability. Documenting your APIs can be made significantly more manageable by selecting the right API documentation tool.

In a previous post, I detailed the benefits of good API documentation. But what exactly do we mean by good documentation? [Read more…]

What is API Documentation, and Why It Matters?

June 6, 2017 By keshav vasudevan

We’re in the multi-platform economy, and APIs are the glue of the digital landscape. A platform is a product that can be extended by a user for the benefit of other users. Any product can become a platform by providing methods for users to add services and functionalities on top of it.

APIs are enablers of the platform economy, and allow users to enhance and add services over existing products. When a product transitions into being a platform, it takes on a new type of user: the third-party developer.

Catering to the developer is tricky. They’re analytical, precise, and are trying to solve important problems with your API. They want to understand how to use your API effectively, which is where API documentation comes into the picture.

In this blog post, we will explore what it means to document your API, and why it’s important to have good API documentation. [Read more…]

Login Button

Posts by keshav vasudevan