Download as PDF, PPTX
![Response
"url": "https://api.github.com/gists/348...",
"committed_at": "2012-08-26T17:40:03Z"
}
],
"git_pull_url": "git://gist.github.com/34819...",
"forks": [
],
"html_url": "https://gist.github.com/3481910",
"git_push_url": "git@gist.github.com:3481910.git",
"comments": 0,
"user": {](https://image.slidesharecdn.com/httpandyourangrydog-120915092109-phpapp02/75/HTTP-and-Your-Angry-Dog-137-2048.jpg)
![Response
HTTP/1.1 200 OK
Server: nginx/1.0.13
Date: Sun, 26 Aug 2012 18:00:43 GMT
Vary: Accept
ETag: "f4e15911542b92b44bb38186e71cc8f5"
{
"history": [
{
"version": "529f6311d5518970903cb5427534b6e1fd313aca",
"user": {
"gravatar_id": "c26bfcbd5f786591e036fa0958a11e8b",
"avatar_url": "https://secure.gravatar.com/avatar/c26bfcbd5f786591e036fa0958a11e8b?d=https://a2...
"login": "rosstuck",
"url": "https://api.github.com/users/rosstuck",
"id": 146766
},
"change_status": {
"additions": 1,
"deletions": 0,
"total": 1
},
"url": "https://api.github.com/gists/3481910/529f6311d5518970903cb5427534b6e1fd313aca",
"committed_at": "2012-08-26T17:40:03Z"
}
],
"git_pull_url": "git://gist.github.com/3481910.git",
"forks": [
],
"html_url": "https://gist.github.com/3481910",
"git_push_url": "git@gist.github.com:3481910.git",
"comments": 0,
"user": {
"gravatar_id": "c26bfcbd5f786591e036fa0958a11e8b",
"avatar_url": "https://secure.gravatar.com/avatar/c26bfcbd5f78659....",}
"login": "rosstuck",
"url": "https://api.github.com/users/rosstuck",
"id": 146766
},
"public": true,
"created_at": "2012-08-26T17:40:03Z",
"files": {
"gistfile1.txt": {
"type": "text/plain",
"filename": "gistfile1.txt",
"raw_url": "https://gist.github.com/raw/3481910/8b6946739e8098408ee3af96...
"content": "Hello PFC!",
"language": null,
"size": 10
}
},
"description": "",
"url": "https://api.github.com/gists/3481910",
"updated_at": "2012-08-26T17:40:03Z",
"id": "3481910"
}](https://image.slidesharecdn.com/httpandyourangrydog-120915092109-phpapp02/75/HTTP-and-Your-Angry-Dog-139-2048.jpg)
Uploaded byRoss Tuck
HTTP and Your Angry Dog
The document discusses HTTP requests and responses. It explains that a request contains a start line with the method, URL and HTTP version, followed by headers providing additional information, and an optional message body. A response contains a status line with the protocol version and status code, followed by headers including caching information, and an optional message body. Content negotiation headers like Accept and Content-Type are used to select the appropriate representation format.
More Related Content
HTTP and Your Angry Dog
- 1. HTTP & YourAngry Dog ZendCon 2014 Ross Tuck
- 2. Freerange Codemonkey Know-It-All Hot-Air Balloon
- 3.
- 4.
- 5.
- 10.
- 15.
- 16.
- 17. Request Response ClientServer
- 18. Request POST /gistsHTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 { "description": "the description for this gist", "public": false, "files": { ...
- 19. Request POST /gistsHTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 { "description": "the description for this gist", "public": false, "files": { ... 2 Parts
- 20. Request POST /gistsHTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 { "description": "the description for this gist", "public": false, "files": { ... The body
- 21. Request POST /gistsHTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 <!DOCTYPE html> <html> <head> <meta charset='utf-8'> <title>My application</title> ... The body
- 22. Request POST /gistsHTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 { "description": "the description for this gist", "public": false, "files": { ... The body
- 23. Request POST /gistsHTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 { "description": "the description for this gist", "public": false, "files": { ...
- 24. Request POST /gistsHTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 { "description": "the description for this gist", "public": false, "files": { ... The headers
- 25. Request POST /gistsHTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 { "description": "the description for this gist", "public": false, "files": { ... The good stuf
- 26. Request POST /gistsHTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 { "description": "the description for this gist", "public": false, "files": { ...
- 27. Request POST /gistsHTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 { "description": "the description for this gist", "public": false, "files": { ... GET, POST, PUT, DELETE
- 28. Request Relative URL POST /gists HTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 { "description": "the description for this gist", "public": false, "files": { ... HTTP version
- 29. Request POST /gistsHTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 { "description": "the description for this gist", "public": false, "files": { ... Key/Value pairs
- 30. Request POST /gistsHTTP/1.1 Authorization: Basic xxxxxxxx Host: api.github.com Content-Length: 146 { "description": "the description for this gist", "public": false, "files": { ...
- 32. Response HTTP/1.1 201Created Date: Sun, 09 Sep 2012 11:42:41 GMT Content-Length: 1848 Location: https://api.github.com/gists/a43a0cf58 { "description": "the description for this gist", "comments": 0, "created_at": "2012-09-09T11:42:40Z", ... Status code
- 34. • 2xx •3xx • 4xx • 5xx OK! Over there! Client screwed up! Server screwed up!
- 35.
- 36. Request GET /dogs/corgiHTTP/1.1 Host: api.example.com
- 37. Response HTTP/1.1 200OK Date: Sun, 26 Aug 2012 18:00:43 GMT { "cute": true, "big": false, "data_dog": true }
- 38. Response HTTP/1.1 200OK Date: Sun, 26 Aug 2012 18:00:43 GMT <dog breed="corgi"> <cute>true</cute> <data capacity="on" /> </dog>
- 39. Request GET /dogs/corgiHTTP/1.1 Host: api.example.com
- 40. Request GET /dogs/corgi.jsonHTTP/1.1 Host: api.example.com
- 41.
- 42. Imagine the URLas your primary key.
- 43. Request GET /dogs/corgiHTTP/1.1 Host: api.example.com
- 44. Request GET /dogs/corgi?_format=jsonHTTP/1.1 Host: api.example.com
- 45. Request POST /dogs/corgi?_format=jsonHTTP/1.1 Host: api.example.com
- 46. Request GET /dogs/corgiHTTP/1.1 Host: api.example.com
- 47. Request GET /dogs/corgiHTTP/1.1 Host: api.example.com Accept: application/json
- 48.
- 49. Request GET /dogs/corgiHTTP/1.1 Host: api.example.com Accept: application/json
- 50. Request GET /dogs/corgiHTTP/1.1 Host: api.example.com Accept: application/json, application/xml How do I choose?
- 52. Request GET /dogs/corgiHTTP/1.1 Host: api.example.com Accept: application/json, application/xml
- 53. Response HTTP/1.1 200OK Date: Sun, 26 Aug 2012 18:00:43 GMT Content-Type: application/json { "cute": true, "big": false, "data_dog": true }
- 54.
- 55. Request GET /dogs/corgiHTTP/1.1 Host: api.example.com Accept: application/json, application/xml
- 56.
- 57.
- 58.
- 59.
- 60. Quality (Default 1.0) text/html, text/plain;q=0.5
- 61.
- 62. Anything at all text/html, text/plain;q=0.5, */*;q=0.1
- 63. Accept Headers Littleweird...
- 64. But not soscary.
- 65.
- 66.
- 67. What the heckis it good for?
- 68. Accept is a“Pattern”
- 69. Accept-Language Accept-Encoding Accept-Charset Accept-Ranges
- 70. Content-Language Content-Encoding (worksdifferently) Content-Range
- 71. /dog/corgi Resource vsRepresentation JSON, Dutch, Gzipped, /dog/corgi
- 72.
- 73. Best way toversion your API. Arguably. Right now.
- 74.
- 75.
- 76.
- 79.
- 80. GET /dogs/corgi HTTP/1.1 Host: api.example.com Client Server
- 81. GET /dogs/corgi HTTP/1.1 Host: api.example.com Client Server
- 82. GET /dogs/corgi HTTP/1.1 Host: api.example.com Client Proxy Server
- 83. GET /dogs/corgi HTTP/1.1 Host: api.example.com Accept: application/json, text/plain User-Species: cat Client Proxy Server
- 84. Same URL. Differentoutput. WTF should I return?
- 85. GET /dogs/corgi HTTP/1.1 Host: api.example.com Accept: application/json, text/plain User-Species: cat Client Proxy Server
- 86.
- 87. Here's how. Hint: Involves the Vary header!
- 88. /dogs/corgi Accept: application/json,text/plain User-Species: cat Client Proxy Server
- 89. Response HTTP/1.1 200OK Date: Sun, 26 Aug 2012 18:00:43 GMT Content-Type: application/json Vary: Accept {“json”: “omgz”}
- 90. URL and Accept? Okay, I got this. Client Proxy Server
- 91.
- 92. /dogs/corgi Accept: application/json,text/plain User-Species: aardvark Client Proxy Server
- 93. Valid cache. Ihas it. Client Proxy Server
- 94. ZZZ Z Z Z Client Proxy Server
- 95. Response HTTP/1.1 200OK Date: Sun, 26 Aug 2012 18:00:43 GMT Content-Type: application/json Vary: Accept {“json”: “omgz”}
- 96. Response HTTP/1.1 200OK Date: Sun, 26 Aug 2012 18:00:43 GMT Content-Type: application/json Vary: Accept, User-Species {“json”: “omgz”}
- 97. Response HTTP/1.1 200OK Date: Sun, 26 Aug 2012 18:00:43 GMT Content-Type: application/json Vary: Accept, User-Species {“json”: “dogs rule, cats drool”}
- 98. Request headers. NotResponse!
- 99. Bad Reputation? 2Reasons
- 100.
- 101.
- 102.
- 103.
- 104.
- 105. Expires Cache-Control HTTP1.0 HTTP 1.1
- 106. Response HTTP/1.1 200OK Expires: Wed, 29 Oct 2014 22:00:00 GMT {“herp”: “derp”}
- 107. Response HTTP/1.1 200OK Cache-Control: max-age=120 {“herp”: “derp”}
- 108. Response HTTP/1.1 200OK Cache-Control: max-age=120
- 109. Expires Cache-Control HTTP1.0 HTTP 1.1
- 110. Response HTTP/1.1 200OK Cache-Control: max-age=120 {“herp”: “derp”}
- 111. Response HTTP/1.1 200OK Cache-Control: max-age=120, s-maxage=120 {“herp”: “derp”} Dude, Where's my dash?
- 112. public private no-store no-cache no-transform must-revalidate proxy-revalidate
- 113. Much better thanme. Mark Nottingham's Caching Tutorial http://www.mnot.net/cache_docs/
- 114.
- 115.
- 116. The Part AboutETags
- 117.
- 118. Request DELETE /ross/reputationHTTP/1.1 Host: api.joind.in If-Talk-Quality: Crap
- 119. if ($talkQuality ==='Crap') { real code delete($rossReputation); Not } Server
- 120. What kind ofconditions?
- 121. If-Match If-None-Match If-Modified-Since If-Unmodified-Since If-Range ETags Datetimes Either
- 122. Wait a second,Ross. Audience
- 123. What the heckis an ETag?
- 124. A string. Anystring.
- 125.
- 126. Represent the currentstate.
- 127.
- 128. ...for the currentrepresentation.
- 129. etag(“v14-json-en”) !== etag(“v14-xml-en”) Don't cross the streams Server
- 130. Last Modified Datesounds easier... Audience
- 131. One second ofprecision Wed, 15 Nov 1995 04:58:08 GMT
- 132.
- 133.
- 134. Request GET /gists/3481910HTTP/1.1 Host: api.github.com Accept: */*
- 135. Response HTTP/1.1 200OK Server: nginx/1.0.13 Date: Sun, 26 Aug 2012 18:00:43 GMT Vary: Accept ETag: "f4e15911542b92b44bb38186e71cc8f5" "history": [ { "version": "529f6311d5518977534b6e1fd313...", ...
- 136. Response ... "user":{ "gravatar_id": "c26bfcbd5f786591e036fa0", "avatar_url": "https://secure.gravatar...", "login": "rosstuck", "url": "https://api.github.com/users/rosstuck", "id": 146766 }, "change_status": { "additions": 1, "deletions": 0, "total": 1 },
- 137. Response "url": "https://api.github.com/gists/348...", "committed_at": "2012-08-26T17:40:03Z" } ], "git_pull_url": "git://gist.github.com/34819...", "forks": [ ], "html_url": "https://gist.github.com/3481910", "git_push_url": "git@gist.github.com:3481910.git", "comments": 0, "user": {
- 139. Response HTTP/1.1 200OK Server: nginx/1.0.13 Date: Sun, 26 Aug 2012 18:00:43 GMT Vary: Accept ETag: "f4e15911542b92b44bb38186e71cc8f5" { "history": [ { "version": "529f6311d5518970903cb5427534b6e1fd313aca", "user": { "gravatar_id": "c26bfcbd5f786591e036fa0958a11e8b", "avatar_url": "https://secure.gravatar.com/avatar/c26bfcbd5f786591e036fa0958a11e8b?d=https://a2... "login": "rosstuck", "url": "https://api.github.com/users/rosstuck", "id": 146766 }, "change_status": { "additions": 1, "deletions": 0, "total": 1 }, "url": "https://api.github.com/gists/3481910/529f6311d5518970903cb5427534b6e1fd313aca", "committed_at": "2012-08-26T17:40:03Z" } ], "git_pull_url": "git://gist.github.com/3481910.git", "forks": [ ], "html_url": "https://gist.github.com/3481910", "git_push_url": "git@gist.github.com:3481910.git", "comments": 0, "user": { "gravatar_id": "c26bfcbd5f786591e036fa0958a11e8b", "avatar_url": "https://secure.gravatar.com/avatar/c26bfcbd5f78659....",} "login": "rosstuck", "url": "https://api.github.com/users/rosstuck", "id": 146766 }, "public": true, "created_at": "2012-08-26T17:40:03Z", "files": { "gistfile1.txt": { "type": "text/plain", "filename": "gistfile1.txt", "raw_url": "https://gist.github.com/raw/3481910/8b6946739e8098408ee3af96... "content": "Hello PFC!", "language": null, "size": 10 } }, "description": "", "url": "https://api.github.com/gists/3481910", "updated_at": "2012-08-26T17:40:03Z", "id": "3481910" }
- 141. Request GET /gists/3481910HTTP/1.1 Host: api.github.com Accept: */* If-None-Match: "f4e15911542b92b44bb38186e71cc8f5"
- 142. Response HTTP/1.1 304Not Modified Server: nginx/1.0.13 Date: Sun, 26 Aug 2012 18:00:43 GMT Vary: Accept ETag: "f4e15911542b92b44bb38186e71cc8f5"
- 143. Response HTTP/1.1 304Not Modified Server: nginx/1.0.13 Date: Sun, 26 Aug 2012 18:00:43 GMT Vary: Accept ETag: "f4e15911542b92b44bb38186e71cc8f5"
- 144. Response HTTP/1.1 304Not Modified Server: nginx/1.0.13 Date: Sun, 26 Aug 2012 18:00:43 GMT Vary: Accept ETag: "f4e15911542b92b44bb38186e71cc8f5" No giant body!
- 145.
- 146. Request GET /gists/3481910HTTP/1.1 Host: api.github.com Accept: */* If-None-Match: "a381bedb5d4478053eb04be35f8798dd"
- 147. Request GET /gists/3481910HTTP/1.1 Host: api.github.com Accept: */* If-None-Match: "ross-is-a-poo-poo-head"
- 148. Response HTTP/1.1 200OK Server: nginx/1.0.13 Date: Sun, 26 Aug 2012 18:00:43 GMT Vary: Accept ETag: "f4e15911542b92b44bb38186e71cc8f5" "history": [ { "version": "529f6311d5518977534b6e1fd313...",
- 149.
- 150. No ETag OldETag Matching ETag Full Body Full Body No Body → → →
- 151.
- 152.
- 153. Parsing Bandwidth Responsetime Probably .Maybe
- 154.
- 155. “The fastest requestis one you don't make.” - Jesus
- 156. More Fun WithETags
- 157. Optimistic Concurrency Control “Record Versioning”
- 158.
- 159. Request GET /gists/3481910HTTP/1.1 Host: api.github.com Accept: */* If-None-Match: "f4e15911542b92b44bb38186e71cc8f5"
- 160. Request PATCH /gists/3481910HTTP/1.1 Host: api.github.com Accept: */* If-None-Match: "f4e15911542b92b44bb38186e71cc8f5"
- 161. Request PATCH /gists/3481910HTTP/1.1 Host: api.github.com Accept: */* If-Match: "f4e15911542b92b44bb38186e71cc8f5"
- 162. Request PATCH /gists/3481910HTTP/1.1 Host: api.github.com Accept: */* If-Match: "f4e15911542b92b44bb38186e71cc8f5" { "description": "cheese om nom nom" }
- 163.
- 164. Response HTTP/1.1 200OK Server: nginx/1.0.13 Date: Sat, 01 Sep 2012 14:01:38 GMT ETag: "899b76047a5e68445668374c2e0faa32" { "description": "cheese om nom nom", "user": { "login": "rosstuck", ...
- 165.
- 166.
- 167. What if Isend something...
- 169. Request PATCH /gists/3481910HTTP/1.1 Host: api.github.com Accept: */* If-Match: "899b76047a5e68445668374c2e0faa32" { "description": "cheese om nom nom" }
- 170. Request PATCH /gists/3481910HTTP/1.1 Host: api.github.com Accept: */* If-Match: "stay-puft-marshmellow-dog!" { "description": "cheese om nom nom" }
- 171. Response HTTP/1.1 412Precondition Failed Server: nginx/1.0.13 Date: Sun, 26 Aug 2012 18:00:43 GMT
- 172.
- 173. Server if (“stay-puft-marshmellow-dog”== “f4e1591..”) { patchTheRecord(); }
- 174. Server if (“stay-puft-marshmellow-dog”== “f4e1591..”) { patchTheRecord(); } else { sendScary412Message(); }
- 175. Your ETag isout of date.
- 176. “Two guys onthe same record” problem
- 177.
- 178. Disclaimer New StuffAhead
- 179. Request DELETE /gists/3481910HTTP/1.1 Host: api.github.com
- 180. Response HTTP/1.1 428Precondition Required Server: nginx/1.0.13 Date: Sun, 26 Aug 2012 18:00:43 GMT
- 181. Am I operatingon the latest version?
- 182. Request DELETE /gists/3481910HTTP/1.1 Host: api.github.com
- 183. Request DELETE /gists/3481910HTTP/1.1 Host: api.github.com If-Match: "f4e15911542b92b44bb38186e71cc8f5"
- 184. Response HTTP/1.1 204No Content Server: nginx/1.0.13 Date: Sun, 26 Aug 2012 18:00:43 GMT
- 185. Look before youleap.
- 186.
- 190. Epilogue: HTTP &Dogs
- 191. Content Negotiation Vary Caching Preconditions
- 192. Treat it likeyour framework.
- 197.
- 198. Resources • RFC7231 –Sections 4 - 7 • http://redbot.org/ • http://mnot.net/cache_docs/ • http://charlesproxy.com/ • http://guzzlephp.org/
- 199. Image Credits •http://www.sxc.hu/photo/555539 • http://www.flickr.com/photos/thedalogs/2953136078/ • http://www.sxc.hu/photo/678952 • http://www.flickr.com/photos/designgate/8317884432/ • http://www.flickr.com/photos/barretthall/3289317664/ • http://www.flickr.com/photos/binaryape/3702275400/lightbox/ • http://www.flickr.com/photos/istolethetv/2956799679/in/photostream/ • http://theflashbackspodcast.blogspot.nl/2012/01/30-day-film-challenge-day-8.html • http://www.flickr.com/photos/jonomueller/6906420190/ • http://www.flickr.com/photos/cookbookman/6175752147 • http://www.flickr.com/photos/creativedc/2913123330/ • http://www.flickr.com/photos/epc/44053757/ • http://www.flickr.com/photos/soggydan/4698849104/ • http://www.flickr.com/photos/owldreams/4430175427/ • http://www.flickr.com/photos/piddleville/2499539542/ • http://www.flickr.com/photos/danja/5665671907/ • http://www.flickr.com/photos/cradlehall/3574160744/ • http://www.flickr.com/photos/ironypoisoning/7114801437/ • http://www.flickr.com/photos/piddleville/2499539542/lightbox/ • http://everydayidrawadog.blogspot.nl/2009_02_01_archive.html
- 200. joind.in/12071 Ross Tuckrosstuck.com @rosstuck