api design approach

11

Click here to load reader

Upload: adrian-gigante

Post on 24-Jan-2018

354 views

Category:

Software


0 download

TRANSCRIPT

Page 1: API Design Approach

API DESIGN APPROACH WHICH ONE SHOULD I CHOOSE?

ADRIAN GIGANTE

Page 2: API Design Approach

“A REST API Is not enough for Enterprise Integration“

Page 3: API Design Approach

An API design approach brings REST to the enterprise...

...and defines the success ofyour work as a developer

Page 4: API Design Approach

So… which one should I choose?

CONSIDER:

DocumentationCommunity supportLanguage supportVersioningCode reuseSDK generation

Page 5: API Design Approach

“Developers are the worst users”

Page 6: API Design Approach

..but choosing an API approach is not like choosing:

Spring vs Java EE

Python vs Ruby

Old school integrationlanguages

…you are not that stuck!

Page 7: API Design Approach

API DESIGN APPROACH GUIDES

Page 8: API Design Approach

Some good API design real life examples…

Page 9: API Design Approach

Some good API design real life examples…

Page 10: API Design Approach

{Thanks}

Page 11: API Design Approach

A REST API Is Not Enough for Enterprise Mobile App Integrationhttp://blog.dreamfactory.com/a-rest-api-is-not-enough

API Spec Comparison Toolhttp://www.mikestowe.com/2014/12/api-spec-comparison-tool.php

API Transformerhttps://apitransformer.com

API Guide Designhttp://design.apievangelist.com/tools.html

Twilio REST Web Service Interfacehttps://www.twilio.com/docs/api/rest

Stripe API referencehttps://stripe.com/docs/api#intro

REFERENCE