Creating Usable REST APIs - Speaker Deck

Tweet

Tweet

Slide 1

Slide 1 text

REST APIs Creating Useable [email protected] @kyle_conroy

Slide 2

Slide 2 text

REST APIs Creating Useable [email protected] @kyle_conroy

Slide 3

Slide 3 text

twilio

Slide 4

Slide 4 text

No content

Slide 5

Slide 5 text

REST

Slide 6

Slide 6 text

No content

Slide 7

Slide 7 text

No content

Slide 8

Slide 8 text

REST APIs Creating Useable

Slide 9

Slide 9 text

REST APIs Creating Useable

Slide 10

Slide 10 text

HYPERMEDIA APIs Creating Useable

Slide 11

Slide 11 text

Level 0: The Swamp of POX Level 1: Resources Level 2: HTTP Verbs Level 3: Hypermedia Controls

Slide 12

Slide 12 text

FROM ZER0 TO HERO API Enlightenment

Slide 13

Slide 13 text

POX

Slide 14

Slide 14 text

one url one method no hypermedia controls HYPERMEDIA

Slide 15

Slide 15 text

Quivr http://github.com/derferman/quivr

Slide 16

Slide 16 text

one url two methods no hypermedia controls

Slide 17

Slide 17 text

docs

Slide 18

Slide 18 text

Level 1 RESOURCES

Slide 19

Slide 19 text

/services/rest?method=flickr.photos.getRecent /services/rest?method=flickr.photos.getInfo /services/rest?method=flickr.photos.getSizes /services/rest?method=flickr.photos.getFavorites

Slide 20

Slide 20 text

/photos /photos/:id /photos/:id/sizes /photos/:id/favorites

Slide 21

Slide 21 text

code

Slide 22

Slide 22 text

Level 2 HTTP VERBS

Slide 23

Slide 23 text

POST /rest?method=flickr.photos.delete POST /rest?method=flickr.photos.setTags

Slide 24

Slide 24 text

DELETE /photos/:id POST /photos/:id

Slide 25

Slide 25 text

code

Slide 26

Slide 26 text

Level 3 HYPERMEDIA CONTROLS

Slide 27

Slide 27 text

(links)

Slide 28

Slide 28 text

code

Slide 29

Slide 29 text

?

Slide 30

Slide 30 text

COOL URLS DON’T CHANGE

Slide 31

Slide 31 text

Resources Embrace HTTP Hypermedia Controls

Slide 32

Slide 32 text

Photo credits http://www.flickr.com/photos/ surfergirl30/6085004536/ http://www.uci.edu/features/2009/12/images/ fielding_091021_01_hxp_a472x315.jpg http://www.flickr.com/photos/locosteve/4349003896 http://www.flickr.com/photos/mikelove/2526016742 http://www.sxc.hu/photo/923625