[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8},"actionData","errors","root",{"_28":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54},"routes/_store+/_readers+/email_author.$slug/route",{"_9":10,"_11":-5},"book",{"_12":13,"_14":15,"_16":17,"_18":19,"_20":21,"_22":23},"currentUser","id","Z2lkOi8vbGVhbnB1Yi9TdG9yZTo6Qm9va1Byb2R1Y3QvMTUwMQ","title","Building RESTful APIs in practice","state","unpublished","contactAuthorMethod","email","aboutText","

So you have read the dissertation of Roy Fielding about REST. You have seen all the slides, blogs and articles on the internet about REST, and you are ready for your first RESTful API. But it turns out that the \"simple rules\" aren't really that simple in practice. Just like playing chess or poker, the rules are one thing, playing the game is something different.

In this book, we will create a RESTful API for a Monopoly gaming site. How do we add users and user-defined boards, streets and cities? How do users \"login\" and how do we make sure users can only move when it's their turn to move. We will cover topics like using hypermedia and hypertext as the engine of state, and how this can be applied to our API. We will show you all the caveats and traps that new - and sometimes experienced - REST designers will fall for, and how to avoid them.

Note that this book is code-agnostic so it is a good read for all kind of developers out there. We won't show you the exact code on how to write the API yourself, but merely what the API should output to your clients or what clients should sent to our API. We will talk about why certain things are done the way they are done, and why you should avoid others ways on occasion.

After reading this book, you will have a more profound idea on how to apply a REST architecture in practice while not falling on back to XML-RPC or other type of protocols.

Contents of the book:

Please note that the contents and order is subject to change.

About this book
Introduction

Introducing REST

Building a RESTful API

About the monopoly game
Why chooce REST for our API?
Desigining the API

User Accounts

Getting user information

Why we don't hardcore URL's in our clients

Mutating users
Adding a new user
Activating the user
Deleting a user
Other user actions
Browsing your API through HTML

The board

Creating a new board

Asynchroneous operations

Displaying the board
Modifying the board

Put vs Patch

Board hierarchy

Representation of resources

Using the board in our game

Game play

Creating new game
Finding games to play

Paginating your data

Searching and filtering games
Connecting to a game

ETags & Optimistic locking

Starting the game
Playing the game
Waiting for your move
Gameplay

HATEOAS in action

Paying rent and buying stuff
Chatting with others

Other REST issues

Dealing with transactions
Content types
Versioning your API
Dealing with composite resources
Using hypermedia formats
Application vs resource state

","authors",[24],{"_12":25,"_26":27,"_28":29},"Z2lkOi8vbGVhbnB1Yi9TdG9yZTo6UHJvZHVjdEF1dGhvci8xNTQ0","name","Joshua Thijssen","user",{"_30":31},"avatar",{"_32":33,"_34":35,"_36":37},"url","https://d39qdlcrvnra4b.cloudfront.net/avatars/18643/medium/jaytaph2.jpg?1425582815","styleName","medium","exists",true,"shoppingCartId","shoppingCart",{"_12":63,"_64":65,"_66":37,"_67":68,"_69":70,"_71":72,"_73":37},"locale","en","readerTheme","light","constants",{"_61":62},"publishers",{"_57":58,"_59":60},"learnerOrganizations",[],"needsLocaleCookieSync",false,"announcements",{"_55":-5,"_56":-5},"announcement_store","announcement_authors","companies",[],"universities",[],"paypalClientId","AX53Cwz8jR6rVVzzZiZNWWXl0dGagi-GZrjG-S3Ua14E5nrKMn7DxDQ730O4R8LusLPp49ALn6aRVaEy","no-cart","count",0,"free","updatedAt","","paymentGateway","STRIPE","cartItems",[],"loading"]

Email the Author