Design and Build Great Web APIs (Pragmatic Bookshelf)

PragmaticBookshelf
Good API design means starting with the API-first principle—understanding who is using the API and what they want to do with it—and applying basic design skills to match customers’ needs while solving business-critical problems.

Mike Amundsen @mamund

edited by Katharine Dvorak @katied

Good API design means starting with the API-first principle—understanding who is using the API and what they want to do with it—and applying basic design skills to match customers’ needs while solving business-critical problems. Use the Sketch-Design-Build method to create reliable and scalable web APIs quickly and easily without a lot of risk to the day-to-day business operations. Create clear sequence diagrams, accurate specifications, and machine-readable API descriptions, all reviewed, tested, and ready to turn into fully-functional NodeJS code.

Create reliable test collections with Postman and implement proper identity and access control security with AuthO—without added cost or risk to the company. Deploy all of this to Heroku using a continuous delivery approach that pushes secure, well-tested code to your public servers, ready for use by both internal and external developers.

From design to code to test to deployment, unlock hidden business value and release stable and scalable web APIs that meet customer needs and solve important business problems in a consistent and reliable manner.


  • Full details: Search
  • View this book’s portal and details on how to post errata and suggestions here.

Don’t forget you can get 35% off with your Devtalk discount! Just use the coupon code “devtalk.com" at checkout :+1:

3 1127 0

Latest Threads About This Book Top

ppoint
@mamund We already know tthat the API URLs for this book were changed to use railway.app instead of herokuapp.com. I noticed yesterday, ...
0 38 1
New
KingDiamondDev
Book tells us to cURL these links: https://company-atk.herokuapp.com (save the output as company-home.json) https://company-atk.her...
1 621 1
New
cpanceac
@mamund Page 59: This text looks wrong: we are in assets/ , then we are in the parrent of assets and then again in assets/ But, most im...
1 451 1
New
javier
Trying out the example on page 9: ​ curl https://activity-atk.herokuapp.com/list returns: <!DOCTYPE html> <html> ...
3 560 2
New
erikj
Hosting the sample code on GitHub seems like it would have several advantages: adopt a popular, contemporary distribution channel provi...
0 665 0
New
erikj
Typo, p. 158: “revious,” should be “previous” Our build process will be the work of turning the prototype we created in the revious cha...
0 682 0
New
erikj
In the javascript specified for package-file.js towards the end of Ch. 5: Typo: "name": "Onboaring API", Typo: it appears that a .yaml...
0 732 0
New
erikj
Web Sequence Diagram example contains typo, ‘compamyData’: compamyData–>-WIP: saveToWIP(identifier, companyName, address, email, tel...
0 698 0
New
ohm
I would love to begin a book club with Mike Amundsen’s (@mamund) book Design and Build Great Web APIs. It seems that building new syste...
8 1049 3
New
scharom16
The zip file containing the source code for the book can not be opened on Unix systems. Error Message: <span class="hashtag-icon-pla...
1 941 5
New

Most Active This Week Top

Most Active This Month Top

Most Active This Year Top

ppoint
@mamund We already know tthat the API URLs for this book were changed to use railway.app instead of herokuapp.com. I noticed yesterday, ...
0 38 1
New

Most Active Last Three Years Top

jeffmcompsci
Title: Design and Build Great Web APIs - typo “https://company-atk.herokuapp.com/2258ie4t68jv” (page 19, third bullet in URL list) Typo:...
8 1913 7
New
KingDiamondDev
Book tells us to cURL these links: https://company-atk.herokuapp.com (save the output as company-home.json) https://company-atk.her...
1 621 1
New
javier
Trying out the example on page 9: ​ curl https://activity-atk.herokuapp.com/list returns: &lt;!DOCTYPE html&gt; &lt;html&gt; ...
3 560 2
New
cpanceac
@mamund Page 59: This text looks wrong: we are in assets/ , then we are in the parrent of assets and then again in assets/ But, most im...
1 451 1
New

Most Active Over Three Years Top

PragmaticBookshelf
Good API design means starting with the API-first principle—understanding who is using the API and what they want to do with it—and apply...
3 1127 0
New
jeffmcompsci
Title: Name of book: Design and Build Great Web APIs (page 25) Two sentences above subtitle Safe and Idempotent: “For example the PATCH...
4 821 1
New
ohm
I would love to begin a book club with Mike Amundsen’s (@mamund) book Design and Build Great Web APIs. It seems that building new syste...
8 1049 3
New
jeffmcompsci
Title: Design and Build Great Web APIs: Incorrect reference to example HTTP request (page 24) Page 23 lists an example HTTP request: "H...
4 1005 1
New
scharom16
The zip file containing the source code for the book can not be opened on Unix systems. Error Message: <span class="hashtag-icon-pla...
1 941 5
New
jeffmcompsci
Title: Name of book: Design and Build Great Web APIs, Delete sentence to create repo in Exercise 1 (page 19) Delete this sentence from ...
5 953 1
New
jeffmcompsci
Title: Design and Build Great Web APIs - typo “actually” (page 22, first paragraph) Typo: “It is important to have a clear sense of the ...
3 867 1
New
jeffmcompsci
Title: Design and Build Great Web APIs (page 31, first paragraph) Original Sentence: “We can improve the quality of our APIs by using th...
4 789 1
New
erikj
In the javascript specified for package-file.js towards the end of Ch. 5: Typo: "name": "Onboaring API", Typo: it appears that a .yaml...
0 732 0
New
erikj
Web Sequence Diagram example contains typo, ‘compamyData’: compamyData–&gt;-WIP: saveToWIP(identifier, companyName, address, email, tel...
0 698 0
New
erikj
Hosting the sample code on GitHub seems like it would have several advantages: adopt a popular, contemporary distribution channel provi...
0 665 0
New
erikj
Typo, p. 158: “revious,” should be “previous” Our build process will be the work of turning the prototype we created in the revious cha...
0 682 0
New
jeffmcompsci
On page 9, it talks about “human readable documentation available in the book’s source code.” What is meant by this? Does that mean the t...
5 770 1
New

Book Info

Publisher: Pragmatic Bookshelf

Are you this book's author? To be notified of all posts made about it, sign up an account then click here, then select 'watching' from the bell icon in the top right corner.

Get money off!

The Pragmatic Bookshelf

35% off any eBook

Simply use coupon code "devtalk.com" at checkout. See full details here.