Hands-On RESTful API Design Patterns and Best Practices

coverpage

Title Page

Copyright and Credits

Hands-On RESTful API Design Patterns and Best Practices

About Packt

Why subscribe?

PacktPub.com

Contributors

About the authors

About the reviewers

Packt is searching for authors like you

Preface

Who this book is for

What this book covers

To get the most out of this book

Download the example code files

Conventions used

Get in touch

Reviews

Introduction to the Basics of RESTful Architecture

Technical requirements

Evolution of web technologies

Learning about Web 3.0

Learning about web service architecture

Discussing the web API

Learning about service-oriented architecture

Learning about resource-oriented architecture

Resource-oriented design

The benefits of ROA

Beginning with REST

REST architecture style constraints

Beginning with client-server

The client in client-server architecture

The service in client-server architecture

Understanding statelessness

Advantages and disadvantages of statelessness

Caching constraint in REST

Benefits of caching

Understanding the uniform interface

Identification of resources

Manipulation of resources

Self-descriptive messages

Hypermedia as the Engine of Application State

Layered systems

Code on demand

RESTful service mandates

Architectural goals of REST

Summary

Design Strategy Guidelines and Best Practices

Technical requirements

Learning about REST API and its importance

Goals of RESTful API design

Affordance

Loosely coupled

Leverage web architecture

API designer roles and responsibilities

API design best practices

API design principles

Ubiquitous web standards

Flexibility

Granularity

Optimized APIs

Functionality

Learning about unusual circumstances

Community standardization

API playgrounds

RESTful API design rules

Learning about Uniform Resource Identifiers

URI formats

REST API URI authority

Resource modelling

Resource archetypes

URI path

URI query

HTTP interactions

Request methods

Response status codes

Metadata design

HTTP headers

Media types and media type design rules

Representations

Message body format

Hypermedia representation

Media type representation

Errors representation

Client concerns

Versioning

Security

Response representation composition

Processing hypermedia

JavaScript clients

Summary

Further reading

Essential RESTful API Patterns

Technical requirements

Beginning with the installations

Beginning with RESTful API patterns – part I

Statelessness

Content negotiation

Content negotiation with HTTP headers