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.    Li...
Resources with Uniform Interface
GET 
   http://srv/spaces/
     addspacenotification.action?key=AJOBS

POST
   http://srv...
Follow HTTP Traffic Laws


   GET- No side-effects, can
  repeat

   POST- Changes state,
  cannot repeat

   PUT- Changes ...
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...
Resource or Operation?
Renew as a Resource
POST
    http://app/accounts/3/renewal




Renew as an Operation
POST
    http:...
REST: the silver bullet?
Thirsty for More?

  Atlassian REST Guidelines 
http://confluence.atlassian.com/x/coDvCg


  Build your own
http://confluenc...
Upcoming SlideShare
Loading in …5
×

Charlie Talk - REST

721 views
673 views

Published on

Learn how Atlassian is standardizing on RESTful web services and how your plugins can take advantage of them.

Published in: Technology, Design
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
721
On SlideShare
0
From Embeds
0
Number of Embeds
34
Actions
Shares
0
Downloads
7
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Charlie Talk - REST

  1. 1. REST Don Brown
  2. 2. State of Atlassian APIs Hard Easy
  3. 3. From SOAP. . . http://www.flickr.com/photos/psd/2217422218/
  4. 4. . . . To REST
  5. 5. REST - The Way of the Web 1.  Nouns, not verbs 2.  Standard methods 3.  Multiple representations 4.  Links everywhere
  6. 6. 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
  7. 7. 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
  8. 8. One API for All
  9. 9. REST in Action
  10. 10. Not everything is a resource Account: o GET . . . Yep o POST . . . Yep o PUT . . . Yep o DELETE . . . Yep o Renew?
  11. 11. Resource or Operation? Renew as a Resource POST http://app/accounts/3/renewal Renew as an Operation POST http://app/accounts/3/renew
  12. 12. REST: the silver bullet?
  13. 13. Thirsty for More?  Atlassian REST Guidelines http://confluence.atlassian.com/x/coDvCg  Build your own http://confluence.atlassian.com/x/FwENCw

×