Don Brown REST
State of Atlassian APIs Hard Easy
From SOAP. . . http://www.flickr.com/photos/psd/2217422218/
. . . To REST
REST - The Way of the Web <ul><li>Nouns, not verbs </li></ul><ul><li>Standard methods </li></ul><ul><li>Multiple represent...
Resources with Uniform Interface <ul><li>GET  </li></ul><ul><ul><li>http://srv/spaces/ addspacenotification .action? key=A...
Follow HTTP Traffic Laws <ul><li>GET  - No side-effects, can repeat </li></ul><ul><li>POST  - Changes state, cannot repeat...
One API for All
REST in Action
Not everything is a resource <ul><li>Account: </li></ul><ul><ul><li>GET . . . Yep </li></ul></ul><ul><ul><li>POST . . . Ye...
Resource or Operation? <ul><li>Renew as a Resource </li></ul><ul><li>POST </li></ul><ul><ul><li>http://app/accounts/3/rene...
REST: the silver bullet?
Thirsty for More? <ul><li>Atlassian REST Guidelines  </li></ul><ul><li>http://confluence.atlassian.com/x/coDvCg </li></ul>...
Upcoming SlideShare
Loading in …5
×

REST

2,270 views

Published on

Short talk given at Atlassian Summit 2009 to discuss how Atlassian is using REST and how Atlassian plugins can use REST too.

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
2,270
On SlideShare
0
From Embeds
0
Number of Embeds
3
Actions
Shares
0
Downloads
31
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

REST

  1. 1. Don Brown REST
  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 <ul><li>Nouns, not verbs </li></ul><ul><li>Standard methods </li></ul><ul><li>Multiple representations </li></ul><ul><li>Links everywhere </li></ul>
  6. 6. Resources with Uniform Interface <ul><li>GET </li></ul><ul><ul><li>http://srv/spaces/ addspacenotification .action? key=AJOBS </li></ul></ul><ul><li>POST </li></ul><ul><ul><li>http://srv/spaces/AJOBS/notifications </li></ul></ul><ul><li>GET, PUT, DELETE </li></ul><ul><ul><li>http://srv/spaces/AJOBS/notifications/3 </li></ul></ul>
  7. 7. Follow HTTP Traffic Laws <ul><li>GET - No side-effects, can repeat </li></ul><ul><li>POST - Changes state, cannot repeat </li></ul><ul><li>PUT - Changes state, can repeat </li></ul><ul><li>DELETE - Changes state, can repeat </li></ul>
  8. 8. One API for All
  9. 9. REST in Action
  10. 10. Not everything is a resource <ul><li>Account: </li></ul><ul><ul><li>GET . . . Yep </li></ul></ul><ul><ul><li>POST . . . Yep </li></ul></ul><ul><ul><li>PUT . . . Yep </li></ul></ul><ul><ul><li>DELETE . . . Yep </li></ul></ul><ul><ul><li>Renew? </li></ul></ul>
  11. 11. Resource or Operation? <ul><li>Renew as a Resource </li></ul><ul><li>POST </li></ul><ul><ul><li>http://app/accounts/3/renewal </li></ul></ul><ul><li>Renew as an Operation </li></ul><ul><li>POST </li></ul><ul><ul><li>http://app/accounts/3/renew </li></ul></ul>
  12. 12. REST: the silver bullet?
  13. 13. Thirsty for More? <ul><li>Atlassian REST Guidelines </li></ul><ul><li>http://confluence.atlassian.com/x/coDvCg </li></ul><ul><li>Build your own </li></ul><ul><li>http://confluence.atlassian.com/x/FwENCw </li></ul>

×