Jeff West / Marsh Gardiner

16 October 2014

Build APIs in Node.js & Swagger 2.0 with Apigee-127

Today’s speakers

Jeff West@jeffreyawest

Marsh Gardiner@earth2marsh

© 2014 Apigee – For Public display

Apigee social channels

3

YouTubehttp://youtube.com/apigee

Slideshare

http://slideshare.com/apigee

© 2014 Apigee – For Public display

Agenda

• JavaScript & APIs• Apigee and Swagger 2.0• Apigee-127 Overview• Apigee-127 Demo• Q&A

© 2014 Apigee – For Public display 5

Who is this webcast for

• API Developers & Designers building new APIs

• Node.js Developers interested in APIs – from n00b to expert

• API Developers & Designers Interested in using/learning about Swagger 2.0

JavaScript & APIs

6

© 2014 Apigee – For Public display

JavaScript For APIs

• On Apigee:

– 67% of developers use JavaScript

– 30% of developers use Node.js

© 2014 Apigee – For Public display 8

Who Uses Node.js ?

Swagger & Apigee

9

© 2014 Apigee – For Public display

The Swagger Ecosystem

• 10,000+ production instances

• 2,000+ downloads/day of Java version

• 10,000+ developers using

• Thousands of devs contributing

• 500+ people in the Working Group

© 2014 Apigee – For Public display

Swagger 2.0

• JSON and YAML formats– Enable top-down and bottom-up workflows

• Code & documentation generation– Programming language agnostic

• Vendor extensions

• Cross-industry participation– Apigee, Getty Images, Intuit, Kaplan,

LivingSocial, McKesson, Microsoft, Morningstar, PayPal, and many more

12

Apigee-127 Overview

13

14

npm install -g apigee-127

http://github.com/apigee-127

© 2014 Apigee – For Public display

Dynamic Server Generation

No static files generated: Apigee-127 works directly from the Swagger spec!

Apigee Extensions

© 2014 Apigee – For Public display

We Handle These:• Swagger Tools (OSS, from Apigee):

• Message validation & routing

• Authorization (OAuth 2.0)

• Node.js Policies (OSS, from Apigee):

• Caching (Apigee Swagger 2.0 Extension)

• Quota (Apigee Swagger 2.0 Extension)

• Analytics (Apigee Swagger 2.0 Extension)

You Handle This:• Business logic

Enterprise-Class APIs, Really Fast

ControllerController.js

© 2014 Apigee – For Public display 17

Apigee-127 Development Environment

• Swagger Editor:

https://github.com/wordnik/swagger-editor

• Swagger Tools:

https://github.com/apigee-127/swagger-tools

• Volos.js:

https://github.com/apigee-127/volos/

• Apache Usergrid (downloaded

separately, using a127):

https://github.com/apache/incubator-usergrid/

Apigee-127 Demo

18

© 2014 Apigee – For Public display

Open Source, Extensible API Services

• Node.js solution for developing and deploying production-level APIs

• npm install volos-{service}-{provider}

• Services:– Caching– OAuth 2.0– Quota– Analytics– Vault

• Providers:– Memory– Redis– Apigee (on Apigee or Remote)

© 2014 Apigee – For Public display 20

Execution Environment Options

Anywhere / PaaS

127 On-Premises / PaaS

127 On Edge

127

Anywhere / PaaS

127 On-Premises / PaaS + Edge

127 127

© 2014 Apigee – For Public display 21

Execution Environment Options

• Apigee Edge provides a robust production-grade execution environment with the following services:– Highly Available Distributed Caching

– Highly Available Distributed Quota

– Highly Available Distributed OAuth

– Highly Available API BaaS

– Highly Available Configuration Management (Key-Value Store)

– Policy Execution Engine

• If you want to run a Node.js API somewhere other than Apigee Edge they will need to implement these services

© 2014 Apigee – For Public display 22

Upcoming FREE Training Sessions

The ABCs of APIs on Node.js and Swagger with Apigee’s Greg Rewis

Coming to a city near you and online on Apigee Academy!

© 2014 Apigee – For Public display 23

Apigee-127 Resources

• Wiki: https://github.com/apigee-127/a127-documentation/wiki

• Help: https://github.com/apigee-127/a127-documentation/wiki/help

• Sign up for announcements with the a127 Google Group: https://groups.google.com/forum/#!forum/a127

• Community Support: http://community.apigee.com

© 2014 Apigee – For Public display 24

Apigee Community Site

http://community.apigee.com

Questions?

Jeff West@jeffreyawest

Marsh Gardiner@earth2marsh

© 2014 Apigee – For Public display

Thank you