[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8},"actionData","errors","root",{"_30":-5,"_45":-5,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":57,"_58":59,"_60":61,"_62":63,"_64":65},"routes/_store+/_readers+/email_author.$slug/route",{"_9":10,"_11":-5,"_12":-5},"book",{"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":24},"currentUser","formToken","id","Z2lkOi8vbGVhbnB1Yi9TdG9yZTo6Qm9va1Byb2R1Y3QvMjE2NDY","title","The Web API Design Guidelines for Happy Developers","state","published","contactAuthorMethod","email","aboutText","

When developing a modern Web Application, it’s increasingly likely that you, as a developer, will need to use an API: be it a social network plugin API, an e-commerce checkout API, a Captcha, a Web Analytics suite. In today’s Web development APIs are ubiquitous.

But as you wandered through dozens of different APIs, you’ve certainly found out already that they’re not all born equal: for each API that is well thought, well documented, easy to understand and fun to use, there are dozens that are obscure and inconsistent, error-prone and tedious.

The goal of this ebook is to provide a set of guidelines through key points/tips on how to design Web APIs that are, at the same time: nice and sound, fun to use and logically consistent. We don’t like to call them REST, as we don’t want to introduce unneeded constraints in our guidelines. We prefer to call them Pragmatic Web APIs.

","authors",[25,26],{"_13":40,"_28":41,"_30":42},{"_13":27,"_28":29,"_30":31},"Z2lkOi8vbGVhbnB1Yi9TdG9yZTo6UHJvZHVjdEF1dGhvci8yMjQ5Mg","name","Federico Pinna","user",{"_32":33},"avatar",{"_34":35,"_36":37,"_38":39},"url","https://d39qdlcrvnra4b.cloudfront.net/avatars/585704/medium/10174855_10152062163452611_6954687514124977253_n.jpg?1450949281","styleName","medium","exists",true,"Z2lkOi8vbGVhbnB1Yi9TdG9yZTo6UHJvZHVjdEF1dGhvci8yMjQ5Mw","Antonio Pintus",{"_32":43},{"_34":44,"_36":37,"_38":39},"https://d39qdlcrvnra4b.cloudfront.net/avatars/587299/medium/ritratto-profilo-maggio14.png?1450980594","shoppingCartId","shoppingCart",{"_13":78,"_79":80,"_81":39,"_82":83,"_84":85,"_86":87,"_88":39},"locale","en","readerTheme","light","constants",{"_76":77},"publishers",{"_72":73,"_74":75},"learnerOrganizations",[],"needsLocaleCookieSync",false,"announcements",{"_66":67,"_68":-5},"sentryEnvironment","production","sentryRelease","48b76f656ed8ca3b58a5234386f01f50d7af0697","announcement_store",{"_69":59,"_70":71},"announcement_authors","flag","text","

Kick off your book project, get started with GhostAI, get better at marketing, or spend the day doing all three! Free live workshops on Zoom. Saturday, June 27, 2026.

\n","companies",[],"universities",[],"paypalClientId","AX53Cwz8jR6rVVzzZiZNWWXl0dGagi-GZrjG-S3Ua14E5nrKMn7DxDQ730O4R8LusLPp49ALn6aRVaEy","no-cart","count",0,"free","updatedAt","","paymentGateway","STRIPE","cartItems",[],"loading"]

Email the Authors