Apigee Product Highlight: Apigee-127's Swagger Editor

Gregory Brail

Jan 14, 2015

At Apigee, we create powerful tools and technology that help developers build APIs and apps. We’ve spent a lot of time improving Apigee Edge support for Node.js, the open-source programming language that runs natively on our platform. We’ve done a lot of work with connectors to enable developers to quickly build APIs that can access data from many different types of backend systems. And we’ve introduced Apigee-127, a toolkit of open source components for building awesome, production-grade APIs in Node.js and Swagger 2.0.

Apigee-127 and Swagger

Building APIs is fast and easy with Swagger, the API description format. Apigee-127’s built-in Swagger editor lets you write your API specs on the left, which automatically generates Swagger documentation on the right. It’s flexible, and it also affects what actually happens at the run time, because unlike some other systems, we don’t parse this and generate code—we actually run this API description when you start the app.

Policies

Adding policies like OAuth is easy, too. You can annotate your API in Apigee-127 to have an API call require OAuth. You can add caching or quotas the same way, with custom parameters in each API resource. All of this is done without writing code.

Implementing and deploying your API

Implementing your API in Apigee-127 requires simply plugging in some JavaScript code. Deploying to Apigee Edge (or other places) takes only an additional minute or two. It gets packaged up, sent to the cloud, and presto, it’s running on Edge, where there are analytics, an industrial grade OAuth system, monitoring, support, and SLAs.

Check out this short video, for some examples of how Apigee-127 and the Swagger editor simplify building and deploying APIs.