Book Image

Hands-On RESTful API Design Patterns and Best Practices

By : Anupama Murali, Harihara Subramanian J, Pethuru Raj
Book Image

Hands-On RESTful API Design Patterns and Best Practices

By: Anupama Murali, Harihara Subramanian J, Pethuru Raj

Overview of this book

This book deals with the Representational State Transfer (REST) paradigm, which is an architectural style that allows networked devices to communicate with each other over the internet. With the help of this book, you’ll explore the concepts of service-oriented architecture (SOA), event-driven architecture (EDA), and resource-oriented architecture (ROA). This book covers why there is an insistence for high-quality APIs toward enterprise integration. It also covers how to optimize and explore endpoints for microservices with API gateways and touches upon integrated platforms and Hubs for RESTful APIs. You’ll also understand how application delivery and deployments can be simplified and streamlined in the REST world. The book will help you dig deeper into the distinct contributions of RESTful services for IoT analytics and applications. Besides detailing the API design and development aspects, this book will assist you in designing and developing production-ready, testable, sustainable, and enterprise-grade APIs. By the end of the book, you’ll be empowered with all that you need to create highly flexible APIs for next-generation RESTful services and applications.
Table of Contents (13 chapters)

SOAP versus REST

SOAP is a matured and stabilized protocol with a number of standard specifications, and these specifications are simplifying and streamlining the development, deployment, management, governance, and composition of services. There are standardized markup languages to represent the interfaces of services. In order to be unambiguously understood, SOAP predominantly uses XML rather than HTTP to define message content. Web services description language (WSDL) can enforce the use of formal contracts between the service API and consumers. SOAP has a built-in WS-reliable messaging standard to increase service security during asynchronous execution and processing. SOAP has a built-in stateful operation capability for conversational state management.

As indicated in the preceding section, REST is easy to understand as it uses HTTP as the data transmission protocol and the...