Getting Started with the WSO2 API Manager

Demo: Getting started with WSO2 API Manager

(outline for demo)

Sumedha Rubasinghe September, 2012

WSO2 API Manager Webinar Series

•Introducing WSO2 API Manager for Mobile Applications and Rapid Integration - September 11 •Getting Started with API Manager - September 18 •API Facade Pattern - September 25 •Promoting Service Re-use with API Management - October 2 •API Management Building Blocks and Business Value - October 9

WSO2 API Manager - Overview

•v1.0.0 – August 2012 •Not really a 1.0.0 product

•Built using, •WSO2 Enterprise Service Bus •WSO2 Identity Server •WSO2 Governance Registry •WSO2 Jaggery

•Only open source API Management Platform •Platform covers all aspects of API Management

•API Provider •API Store & Consumer •Gateway •Monitoring & Statistics

Production

deployments

with various

clients around

the globe

API Manager – Functional Overview

Concept: Service/Resource vs API

•Service/Resource •Implementation •Represent Provider

•API •Represent Consumer/Subscriber •Service/Resource’s interface to external world •“API Management” – Process of creating & managing APIs

Creating & Publishing an API

•Demo •Summary

•Select implemented Service/Resource endpoint •Create API

•API Context •API Version •Tier, Tags

•Documentation •Change Status

DEMO

API Store & Subscriptions

•Demo •Summary

•Publisher APIs appear on Store •Tags •Sorted (recently added, popular)

•Sign up •Logged in users (consumers) can subscribe

DEMO

Concept : Application

•Application •Logical grouping of all APIs being used for a purpose •Subscription = API + Version + Application •Access token -> application scope

DEMO

(Quick) API Testing Clients

•Demo •cURL •soapUI •JMeter •Chrome Plugins

•Advance REST Client •REST Console

•Firefox Plugins •Mozilla Poster

•Apache Bench

DEMO

Concept : Access Token

•OAuth Token (Valet Key) •To be used during development testing ONLY •Generated using API Store UI

DEMO

Concept : Access Token

•Per end user key •Generated by the application instance running on behalf of user •Generated using consumer_key + consumer_secret •Special URL to submit token generation requests •Helps to uniquely identify end users •Management & stat gathering

Developing Apps using APIs

•Select correct throttle policy •Developer token can be used for development •Every new installation of app should obtain a new token •Do not include include developer key

•Set global expiration time on tokens

API Statistics

DEMO

Event Stream Definition

Service Lifecycle vs API Lifecycle

API Versioning Support

•Demo •Summary

•Current API version -> copy to new version •Copies all documentation •Version as part of URL •Access Token -> version •Stats -> version

DEMO

Passing End User to Backend

•JWT( JSON Web Token)

WSO2 API Manager Webinar Series

•Introducing WSO2 API Manager for Mobile Applications and Rapid Integration - September 11 •Getting Started with API Manager - September 18 •API Facade Pattern - September 25 •Promoting Service Re-use with API Management - October 2 •API Management Building Blocks and Business Value - October 9

WSO2 Conference Call For Papers

•Visit wso2con.com – Submission Deadline 7th Oct 2012

Questions?

References : •http://wso2.com/products/api-manager/ •Getting Started Guide - http://d.content.wso2.com/files/WSO2APIManager-v1.0.0-GettingStarted.pdf •http://sanjiva.weerawarana.org/2012/08/api-management-missing-link-for-soa.html •http://techfeast-hiranya.blogspot.com/search/label/api%20management •http://sumedha.blogspot.com/search/label/API