Errata

"this book will show you to do it" should read "this book will show you how to do it"

"It shows" -> "We show"

The comment says "amazon-book-search.rb", but the next page executes "ruby amazon-search.rb".

Note from the Author or Editor:
On page 3, change "ruby amazon-search.rb" to "ruby amazon-book-search.rb".

Paragraph has double quotes after the '4' that should be removed:
In Section 5.4"

Corresponds to page 123 of print book. Problem is only in Safari version.

"Starting in chapter 5" -> "Starting in chapter 4"
"In Resource-Oriented Architectures" -> "In resource-oriented architectures"

"happen to live into the URI portion" should read "happen to live in the URI portion"

"a RESTful web services" -> "a RESTful web service"

"under same rules" -> "under the same rules"

The sentences starting "The del.icio,.us web service sends back..." should go between example 2-2 and example 2-3.

Your ditto marks are not clear to me. It seems that they must be read horizontally, e.g. Net:HTTP provides Basic support for Auth methods, No support for Caching, and Yes support for Proxies.

I have always only used ditto marks vertically - I've never used them horizontally, so your matrices (not
just the one on page 32) are confusing

Note from the Author or Editor:
Explicitly spell out the ditto marks in tables 2-1, 2-2, and 2-3.

To avoid repeating "Yes (assuming the net/https library is installed)" and "Yes (assuming Python was compiled with SSL support)", put "Assuming the net/https library is installed" and "Assuming Python was compiled with SSL support" into a footnote, and just say "Yes" three times:

HTTPS | Yes* | Yes* | Yes* |
HTTP verbs | GET | All | All |
Custom data | No | Yes | Yes |
Custom headers | Yes | Yes | Yes |
...

* Assuming the `net/https` library is installed.

Similarly for table 2-2:

HTTPS | Yes* | Yes* | Yes* |
HTTP verbs | GET, POST | All | All |
Custom data | Yes | Yes | Yes |
Custom headers | Yes | Yes | Yes |
...

* Assuming Python was compiled with SSL support.

/**
* A command-line application that fetches bookmarks from del.icio.us
* and prints them to strandard output.
*/

strandard --> standard

"Basic HTTP, GET, and POST" -> "Basic HTTP GET and POST"

"defects the RPC style" -> "defects to the RPC style"

"39 official HTTP" -> "41 official HTTP"

"Now, as shown in Example 3-6, let's write the S3::Bucket class,"
->
"Now, let's write the S3::Bucket class (Example 3-6),"

"This is a job for public-key cryptography" -> "S3 solves this problem using a message authentication code (MAC)".

your "private" key (remember, not truly private: Amazon knows it too)"
->
your secret key (remember, the secret is shared between you and Amazon)

Only someone with the "private" key
->
Only someone who knows the secret

revealing your "private" key
->
revealing the secret

know your "private" key
->
know your secret

signs it (again, Amazon has a copy of your "private"key)
->
signs it (again, Amazon knows your secret key)

It says "# Add it to the header has." I think it meant to say "hash" ;)

Note from the Author or Editor:
Change

# Add it to the header has.

to

# Add it to the header hash.

The paragraph suggests using the 'scaffold_resource' generator, but this does not exist in the version of Ruby shipped with OS X 10.6.2 (Ruby 1.8.7).

Using 'scaffold' in place of 'scaffold_resource' appears to work correctly.

Note from the Author or Editor:
Change 'scaffold_resource' to 'scaffold' throughout this page. Rails generates different files now, but the general picture is correct.

"in Preface" -> "in the Preface"

"Name the Resources" section. -> "Name the Resources" section of chapter 5.

"start=50, and" -> "start=500, and"

The two sentence beginning "However, there is something unRESTful"
should be put into parentheses or made into a footnote. "The Trouble
with Cookies" should include a reference to the chapter in which it's
found: chapter 8.

"neccessary" -> "necessary"

"addressabile" -> "addressable"

"bits of client state" -> "bits of application state"

"process it" -> "process the request"

"That's client state:" -> "That's application state:"

"and the server restricts" -> "and the server"

"unneccessary" -> "unnecessary"

cache of the extrenal page
=>
cache of the external page

"saw the HEAD method" -> "You saw the HEAD method"

'neccessary' -> 'necessary'

'...and use it...' -> 'and uses it'

"accepts POST requests" -> "accepts a POST request"

"Multiplying by any other number" -> "Multiplication by any other number"

"50" -> "-50"

Anything that might be refereed to by name ought...
should be:
Anything that might be referred to by name ought...

"I'm going to use a comma to separate latitude and longitude." Then the next paragraph uses semicolon "/v1/Earth/43.9;-103.46..." and semicolon runs rampant throughout chapters 5 and 6.

Note from the Author or Editor:
The following URIs should have a comma separating latitude and longitude instead of a semicolon. Page numbers are given for the PDF edition:

p139: /v1/Earth/43.9;-103.46/Mount%20Rushmore
p143: http://maps.example.com/Earth/24.9195;17.821?show=arsenic
p147: /road.1/Earth/37.0;-95.8
p147: /road.3/Earth/37.0;-95.8
p148: http://maps.example.com/road/Earth.8/images/37.0;-95.png
p151: /Earth/43.9;-95.9
p151: /road/Earth/43.9;-95.9
p151: /satellite/Earth/43.9;-95.9
p152: /Earth/43.9;-103.46
p152: /road/Earth/43.9;-95.9
p152: /satellite/Earth/43.9;-95.9
p153: /Earth/43.9;-95.9/Mount%20Rushmore
p159: /Earth/43.9;-95.9/Mount%20Rushmore
p178: /user/samruby/Earth/45.2;-114.2/Joe?s%20Diner
p178: /user/leonardr/Earth/45.2;-114.2/Joe's%20Diner
p179: /user/bob/Earth/42;-93.7/the%20cornfield%20where...
p179: /Earth/42;-93.7
p179: /user/leonardr/Earth/43.9;-103.46/Mount%20Rushmore
p180: /Earth/43.9;-103.46
p182: /Earth/42;-93.7
p182: /Earth/43.9;-103.46
p182: /Earth/43.9;-103.46
p183: /road/Earth/43.9;-103.46
p183: /satellite/Earth/43.9;-103.46
p184: /user/leonardr/Earth/43.9;-103.46/Mt.%20Rushmore
p185: /user/leonardr/Earth/43.9;-103.46/Mt.%20Rushmore
p245: /road.1/Earth/37.0;-95.8
p245: /road.3/Earth/37.0;-95.8
p246: /road.8/Earth/40.76;-73.98.png

The footnote should be attached to "detailed", not "get."

[{url="http://maps.example.com/Earth,description="Earth"},
{url="http://maps.example.com/Venus,description="Venus"},

should have quotes after the text of each URL:

[{url="http://maps.example.com/Earth",description="Earth"},
{url="http://maps.example.com/Venus",description="Venus"},

Both figures should say "(Image data courtesy Google Maps")

"directly to the east" -> "the part directly to the east"

"steps 3 and 4" -> "steps 4 and 5"

"ang architecture" -> "an architecture"

"if you know one you can calculate the other" -> "if you know the
former you can calculate the latter".

"There's already a solution for this built into HTTP: conditional GET. I cover it briefly in __"Conditional HTTP GET"__ later in this chapter and I'll cover it in more detail in __"Conditional GET,"__ but in this chapter you'll see it implemented. By implementing conditional GET, I can give the time- and bandwidth-saving benefits of posts/update to most of of the resources I'm exposing, not just the single most expensive one."

For the first, it should be "Conditional GET" actually. For the second, it should be "Conditional GET in Chapter 8"

Note from the Author or Editor:
Change this sentence:

I cover it briefly in ?Conditional HTTP GET? later in this chapter and I?ll cover it in more detail in ?Conditional GET,? but in this chapter you?ll see it implemented.

to this:

I cover it briefly in ?Conditional GET? later in this chapter and I?ll cover it in more detail in Chapter 8, but in this chapter you?ll see it implemented.

The last sentence of the section "The Leftovers" contains a redundant "of".

...reimplements something you can already, do...

should be

...reimplements something you can already do...

(without comma)

The last sentence of the 4th paragraph missed a period at the end of the sentence after "more generally".

The title tag is not closed properly.

Note from the Author or Editor:
Change

<title>REST and WS-*/title>

to

<title>REST and WS-*</title>

# There was a problem saving the __bookmark__ to the database.
# Send the validation error messages along with a response
# code of 400.

should be user account actually.

Note from the Author or Editor:
Change "There was a problem saving the bookmark" to "There was a problem saving the user".

"data validation errors fail" -> "data validation fails"

"I can get this data fairly easily with ActiveResource, and format it as a representation with to_xml__but what about security__?"

There should be a comma before "but what about security".

This PUT handler is a little __tricker__ than others, ....

should be "trickier" actually.

"In the bookmarking service from Chapter 7, I exposed two representations of a set of bookmarks: a generic XML representation at /v1/users/leonardr/bookmarks.xml, and an __Atome__ representation at /v1/users/leonardr/bookmarks.atom.

should be "Atom" instead of "Atome"

"Atome" -> "Atom"

see "Overloading POST -> see "Overloading POST" below

"the link text indicate"
should be
"the link text indicates"

The sentence starting "Except for the protocol change..." should be in
parentheses.

"URI templates" -> "URI Templates"

"about it use" -> "about its use"

"If the client then..." -> "If a client"

"from resource is" -> "from http://www.example.com/resource is"

put this token the Authorization header -> put this token in the
Authorization header

his --> her

authorization --> authentication

Note from the Author or Editor:
Change "fake authorization page" to "fake authentication page".

A new line should be inserted after the Media type line.

Lists one of the 15 possible resource relationships as "stylesteet" when it should read "stylesheet"

"neccessarily" -> "necessarily"

The sentence starting "The Universal Encoding..." should be a footnote or else put in parentheses.

"if you're using UTF-16" -> "UTF-16"

'https://s3.amazonaws.com/, and then the bucket name' should be in quotes.

"content type" should be "media type" throughout.

Indentation in example 9-10 is off. The second <doc> tag should be
beneath its enclosing <param> tag, and the <resource path="recent"> tag
should be beneath its enclosing <resource> tag.

Similarly for Example 9-11. The <doc> tags should be indented beneath their enclosing <param> tags.

"SOAP messages, send over HTTP" -> "SOAP messages, sent over HTTP."

"It abstracts away" -> "They abstract away"

"It's possible to prove the originator of a given message was long after it sent, and that the message was
not modified after it was received" -> "It's possible to prove who the originator of a given message was
long after it was sent, and that the message was not modified after it was sent." (Of course, if it hasn't
been modified since it was received, it hasn't been modified since it was sent, but the recipient
generally wants to be sure that the message hasn't been tampered with before receipt.)

"one-off solutions are possible" -> "one-off solutions are not possible".

"this next." -> "this later."

"The chart below has the details, but"
Strike. There is no chart.

Paragraph "There's also an insecure method" should be in parentheses.

The text refers to "the Ajax application delicious-ajax.html," but I don't think the name is used
elsewhere. This seems to be referring to the Ajax client listed in Examples 11-1 through 11-5.

Note from the Author or Editor:
Change "The Ajax application delicious-ajax.html" to "The Ajax application defined in Examples 11-1 through 11-5".

"GET, POST, and/or DELETE" -> "GET, PUT, and/or DELETE"

"six standard methods" -> "five standard methods"

also

"PUT /weblogs/{ID}: Delete a weblog"
"PUT" should be "DELETE"

Application box in Fig 12-2 should contain three different resources to match the subsequent code snippet: UserResource, BookmarksResource, and BookmarkResource. The (plural) BookmarksResource is missing from Figure 12-2.

Note from the Author or Editor:
Change the lowermost box in figure 12-2 to say "BookmarksResource" instead of "BookmarkResource".

The indenting of the code in the if statement is inconsistent.

Note from the Author or Editor:
The five lines starting with:

sb.append("User details\n");

and ending with:

result = new StringRepresentation(sb);

should be indented right four spaces to line up with the first call to sb.append().

"users/jacobian/tags/python" should be "users/jacob/tags/python" to match the prose that follows, or the prose should change from "jacob" to "jacobian."

Note from the Author or Editor:
Change 'two arguments: "jacob"' to 'two arguments: "jacobian"'.

"few resources of your own" -> "few new resources"

"their request" -> "the request"

"The client sends an Accept-Charset header" should be "The client sends an Accept-Language header".

(May 2007: First Edition)

"described next" -> "described later"

"take the value of Expires should as a rough guide" -> "take the value of Expires as a rough guide".

"If-Not-Modified" should be "If-Unmodified-Since"