Designing Web APIs

Errata for Designing Web APIs

Submit your own errata for this product.


The errata list is a list of errors and their corrections that were found after the product was released.

The following errata were submitted by our customers and have not yet been approved or disproved by the author or editor. They solely represent the opinion of the customer.


Color Key: Serious Technical Mistake Minor Technical Mistake Language or formatting error Typo Question Note Update



Version Location Description Submitted By Date Submitted
ePub Page 20
Example 2-2

The example uses an incorrect endpoint path: ``` POST /v1/charges/ch_CWyutlXs9pZyfD ``` I believe this should be: ``` POST /v1/charges ```

Matt Marsh  Jul 01, 2021 
PDF Page 120
In contrast, repositories.fetchSingle [..]

Inside of that array is an array of objects keyed by the actual ID value, instead of by the string "id". Should be: Inside of that array is an object keyed by the actual ID value, instead of by the string "id".

Ron ter Borg  Oct 09, 2018 
PDF Page 125
example code

Example 7-5.[..] ... it "can fetch all repositories successfully", acceptance: true do create_repository_factory (product: 'std') Should be: ... "it can fetch all repositories successfully", acceptance: true do create_repository_factory (product: 'std')

Ron ter Borg  Oct 09, 2018 
PDF Page 137
Fig. 7-4

The function declaration: function_1(){...} should be: function_2(){...}

Ron ter Borg  Oct 10, 2018 
PDF Page 159
hyperlink

objective key results (OKRs) should be: Objectives & Key Results (OKRs)

Ron ter Borg  Oct 15, 2018 
PDF Page 167
paragraph 1, last sentence

"Begin by covering the complex parts of your API and then move to more simple things, if you have the bandwidth." Should this not be the opposite: "Begin by covering the simple parts of your API and then move to more complex things, if you have the bandwidth."

Ron ter Borg  Oct 15, 2018 
PDF Page 173
second last paragraph

[..] or the chat app that Twitch built into its sample. I do not understand the term 'into its sample'. Should this not be 'into its API'?

Ron ter Borg  Oct 18, 2018 
PDF Page 192-193
last sentence

[..], and community leaders are measured on the meetup cadence. What does the author mean by this? It is not clear to me.

Ron ter Borg  Oct 16, 2018