Book Image

Hands-On RESTful Web Services with Go - Second Edition

By : Naren Yellavula
Book Image

Hands-On RESTful Web Services with Go - Second Edition

By: Naren Yellavula

Overview of this book

Building RESTful web services can be tough as there are countless standards and ways to develop API. In modern architectures such as microservices, RESTful APIs are common in communication, making idiomatic and scalable API development crucial. This book covers basic through to advanced API development concepts and supporting tools. You’ll start with an introduction to REST API development before moving on to building the essential blocks for working with Go. You’ll explore routers, middleware, and available open source web development solutions in Go to create robust APIs, and understand the application and database layers to build RESTful web services. You’ll learn various data formats like protocol buffers and JSON, and understand how to serve them over HTTP and gRPC. After covering advanced topics such as asynchronous API design and GraphQL for building scalable web services, you’ll discover how microservices can benefit from REST. You’ll also explore packaging artifacts in the form of containers and understand how to set up an ideal deployment ecosystem for web services. Finally, you’ll cover the provisioning of infrastructure using infrastructure as code (IaC) and secure your REST API. By the end of the book, you’ll have intermediate knowledge of web service development and be able to apply the skills you’ve learned in a practical way.
Table of Contents (16 chapters)

Designing MongoDB documents for a delivery logistics API

There are many cases for which a REST API can be developed. One such case is delivery logistics. In the logistics world, many entities play an important role. To know what to implement, you need to know the terminology that's used for logistics. Here, we are going to model a few JSON documents that can be implemented for MongoDB. After going through this section, try to use this schema information as a guide to building a Logistics REST API.

The following six minimal components are essential in any delivery logistics design:

  • Sender
  • Receiver
  • Package
  • Payment
  • Carrier
  • Shipment

Let's look at a schema for each and every component:

  1. A sender is a person sending the package:
{
_id: ObjectId("5cfe142a7ba402aacb71f710"),
first_name: "Philip",
last_name: "Zorn",
address: {
type: &quot...