Poli 2.0 - APIs

APIs

“An application programming interface (API)  is  a  set  of functions, procedures,

methods or classes that an operating system, library or service provides tosupport requests made by computer programs.[1] ”

“ Web services are frequently just Web APIs that can be accessed over anetwork, such as the Internet, and executed on a remote system hosting therequested services. ”

Resources — Commands are defined in simple terms: resources  to be retrieved, stored / get, set

Nouns — Exchanging resources and concepts

Commands — Commands are defined in methods with varying complexity: depending on “standard” 

Verbs — Exchanging methods

RPC vs. REST

RPC vs. REST

http://example.com/users/http://example.com/users/{user}http://example.com/findUserFormhttp://example.com/locations/http://example.com/locations/{location} http://example.com/findLocationForm ...

getUser() addUser()removeUser()updateUser()getLocation()addLocation()removeLocation()updateLocation()listUsers()listLocations()findLocation()findUser() ...

Most web services use RESTful APIs!

...or at least “accidently RESTful”

RSSAtomPHP...

JSONjsonFlickrApi({ "stat": "ok",

"blogs": { "blog": [ { "id" : "73", "name" : "Bloxus test", "needspassword" : "0", "url" : "http://remote.bloxus.com/" }, ] } })

XML<blogs> <blog id="73" name="Bloxus test" needspassword="0" url="http://remote.bloxus.com/" /> </blogs>

Mashup!

http://api.uberVU.com

• ubervu.test.echo• ubervu.conversations.track• ubervu.conversations.getList• ubervu.conversations.getReactions

Case Study

http://code.uberVU.com/ureactWordPress Plugin

Exercise!          Widget