REST
Don Brown

State of Atlassian APIs
Hard
Easy

From SOAP. . .
http://www.flickr.com/photos/psd/2217422218/

. . . To REST

REST - The Way of the Web
1. Nouns, not verbs
2. Standard methods
3. Multiple
representations
4. Links everywhere

Resources with Uniform Interface
GET
http://srv/spaces/
addspacenotification.action?key=AJOBS
POST
http://srv/spaces/AJOBS/notifications
GET, PUT, DELETE
http://srv/spaces/AJOBS/notifications/3

Follow HTTP Traffic Laws
GET- No side-effects, can
repeat
POST- Changes state,
cannot repeat
PUT- Changes state, can
repeat
DELETE - Changes state,
can repeat

One API for All

REST in Action

Not everything is a resource
Account:
o GET . . . Yep
o POST . . . Yep
o PUT . . . Yep
o DELETE . . .
Yep
o Renew?

Resource or Operation?
Renew as a Resource
POST
http://app/accounts/3/renewal
Renew as an Operation
POST
http://app/accounts/3/renew

REST: the silver bullet?

Thirsty for More?
Atlassian REST Guidelines
http://confluence.atlassian.com/x/coDvCg
Build your own
http://confluence.atlassian.com/x/FwENCw