keshav vasudevan

Introducing the New SwaggerHub Apigee Integration

July 19, 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

Scot Hastings, CIO of Bonotel Exclusive Travel, manages an internal IT team of 11 software developers, as well as a team of 75 external development resources. The internal team built and continues to maintain a complex distributed network that relies on a mix of legacy and modern, native cloud components supported by a microservice based architecture. These combined technologies drive the applications that enable Bonotel to provide travel services to its customers.

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…]

The Importance of Standardized API Design

May 26, 2017 By keshav vasudevan

Consistency in the API design space is a topic that’s being widely discussed. Standardized API design is the next important consideration organizations would need to have in their journey in making APIs that are easy to maintain, adopt and consume. That said, organizations don’t invest enough time in standardizing the way APIs are designed within their organization, partly because they don’t realize the value of doing so.

In this article, I want to discuss what it means to have a consistent organizational style in the design of APIs, and what are the benefits it can offer.
[Read more…]

Mulesoft Joins the Open API Initiative: What to Expect from Swagger and the OAS

April 25, 2017 By keshav vasudevan

OASSwaggerIMG

On April 24, 2017, the news of Mulesoft joining the Open API Initiative hit the wire. Mulesoft is the proponent of the RESTful API Modeling Language (RAML), a description format for designing APIs.

Mulesoft joining the OAI signals the convergence of the software industry on the Swagger/Open API Specification (OAS). I wanted to take this opportunity to discuss a little history, and what we can expect for the future of the OAS. [Read more…]

Login Button

Posts by keshav vasudevan