APIdays Paris - How to Build Your Web API

Post on 28-Jun-2015

53 views 0 download

Tags:

description

Steve Sfartz, VP Engineering of Restlet shares our experience in building a web API via DIY (Do It Yourself) approach or via PaaS approach (APISpark). Introduction to both open source Restlet Framework and public beta of APISpark. Watch the presentation here: https://www.youtube.com/watch?v=s3Ft8GC2BYM

Transcript of APIdays Paris - How to Build Your Web API

BUILD, HOST AND MANAGEYOUR CUSTOM API IN LESS THAN AN HOUR

All-in-one platform for Web APIshttp://apispark.com

December 5, 2013

Stève SFARTZssfartz@restlet.com

VP of Engineering

BIO

Steve SFARTZ

VP of Engineering @ Restlet

APISpark devs & ops teams

Restlet Framework dev teams

Scalable & interoperable architectures

Keeping in touch

ssfartz@restlet.com

Twitter : @SteveSfartz

Blog : Think big … mais pas trop !

WEB API PROJECTTYPICAL LIFE CYCLE

Create Host Manage Use Promote

1) Do It Yourself (DIY)

long, risky, expensive but highly flexible

2) Platform as a Service (PaaS)

integrated, fast, cost effective

DO IT YOURSELF APPROACH

with the Restlet framework

RESTLET FRAMEWORKOPEN SOURCE PROJECT STARTED IN 2005

A N D R O I D G A E G W T J A V A E EJ A V A S E O S G I

Editions for

Create (and consume) Web APIs

in a REST style

LARGELY USED

SELF HOSTED OR EMBEDDED

FILTERING AND ROUTINGMULTI-THREADED AND DYNAMIC

Restlet Resource

Filter

B

C

A

Router

B

C

A

Route 1

Route 2

Route 3

A

B

C

UNIFIED APPROACH

FOR CLIENT AND SERVER SIDES

HTTP

Annotated

Java interface

REST API

Client

resourceServer

resource

Client

proxyServer

subclass

CONVERSION SERVICEEXTENSIBLE, SCORING, BEANS DE REPRÉSENTATION

Resource

XML

HTML

JSON

StateRepresentation

bean

Form Data

RDF

Atom

Converter

service

MULTIPLE PROTOCOLSHTTP COMES FIRST, EXTEND IT TO SUIT YOUR NEEDS

Semantics

Messaging

Payload

Conditional requests

Rangedrequests

Caching Authentication

Restlet

API

Restlet

Engine

Protocoles

• HTTP

• AJP

• FTP

• RIAP

• CLAP

• FILE

• POP3

• SMTP

• JDBC

• SIP

CLOUD INTEGRATIONTUNNEL YOUR IT AND EXPOSE INTERNAL DATA

PAAS APPROACH

with APISpark

APISPARK PLATEFORM

Send us your feed-back and help us making it the best PaaS for Web

APIs !

BUILD YOUR DATA SOURCE

Step 1

DIY APPROACH

Select a database technology

that scales

Specify the schema

tables / sets, keys / queries, indexes

Setup the database

On premise or in the Cloud

Ensure security, high availability and performances

From days to weeks

PAAS WAYBACK END AS A SERVICE

CREATE YOUR WEB API

Step 2

DIY APPROACH

Select an API framework that

Lets you be productive and gets you on the way

Leverages your skills

Ensures your web API will scale and be secure

Write the code

Code, debug, unit tests

Read, write, update your data

Package the code

From days to weeks

PAAS WAYFULLY AUTOMATED

DEPLOY YOUR WEB API

Step 3

DIY APPROACH

Choose a deployment target Private hosting with firewall / DMZ Public hosting : Cloud / Dedicated

Select an API management solution Build your own from Open source, third

party products Leverage an API management service :

plug it in tasks and side effects

Guaranty your SLA Test, QA, iterate, benchmark…

From days to weeks to get started

PAAS WAYINSTANT DEPLOY AND AUTO SCALE

PROMOTE YOUR API

Step 4

DIY APPROACH

Write your API documentation

Annotated your API code and generate ?

Use HTML tooling ?

Maintenance costs (versions sync)

Provide client SDKs

Write first SDKs

Pray for community contributions for others ?

Test, QA, iterate, etc.

From days to weeks to get started

PAAS WAYGENERATE CLIENT SDKS

PAAS WAYBUILT-IN ANALYTICS

DIY VERSUS PAASSUMMARY

From weeks to months

Web API manager

Custom code

Web API framework

Generic PaaS

Hosting

Current practice:• Team of engineers• Heterogeneous stack• Complex & expensive

to develop andto operate

From minutes to hours

API Spark• creation• hosting• management• usage

All-in-one PaaS

Web API definition

HOW MANY APIS ? TO BUILD AND MAINTAIN

Web Site

Pages + API

Browser

Connected devices

Smartenvironment

Business Partners Internal IT

HTTP

FINAL THOUGHTS

How to build 1 million API in 2017 ?

– with radically simpler PaaS for Web APIs

– truly democratize Web APIs !

Source: Wired / June 2013

THE ALL-IN-ONE PLATFORM FOR

WEB APIS

JOIN US

DevOps Engineers

R&D Engineers

Internships : R&D, devops

Location : France (Nantes)

http://restlet.com/about/hiring

KEEP IN TOUCH!

http://apispark.com

Twitter: @apispark

ssfartz@restlet.com