Building RESTful Web services with Go

Building RESTful Web services with Go

By : Naren Yellavula

Buy this Book

Building RESTful Web services with Go

By: Naren Yellavula

Buy this Book

Overview of this book

REST is an architectural style that tackles the challenges of building scalable web services and in today's connected world, APIs have taken a central role on the web. APIs provide the fabric through which systems interact, and REST has become synonymous with APIs. The depth, breadth, and ease of use of Go, makes it a breeze for developers to work with it to build robust Web APIs. This book takes you through the design of RESTful web services and leverages a framework like Gin to implement these services. The book starts with a brief introduction to REST API development and how it transformed the modern web. You will learn how to handle routing and authentication of web services along with working with middleware for internal service. The book explains how to use Go frameworks to build RESTful web services and work with MongoDB to create REST API. You will learn how to integrate Postgres SQL and JSON with a Go web service and build a client library in Go for consuming REST API. You will learn how to scale APIs using the microservice architecture and deploy the REST APIs using Nginx as a proxy server. Finally you will learn how to metricize a REST API using an API Gateway. By the end of the book you will be proficient in building RESTful APIs in Go.

Title Page

Credits

About the Author

Acknowledgments

About the Reviewer

www.PacktPub.com

Customer Feedback

Preface

Free Chapter

Getting Started with REST API Development

Types of web services

REST verbs and status codes

Rise of REST API with Single Page Applications

Setting up the project and running the development server

Building our first service – finding the Roman numeral

Using Gulp for creating auto code compiling and server reloading

Summary

Handling Routing for Our REST Services

Getting the code

Understanding Go's net/http package

ServeMux, a basic router in Go

Introducing httprouter, a lightweight HTTP router

Introducing Gorilla Mux, a powerful HTTP router

Creating a basic API layout for URL shortening services

Summary

Working with Middleware and RPC

Getting the code

What is middleware?

Multiple middleware and chaining

Painless middleware chaining with Alice

Using Gorilla's Handlers middleware for Logging

What is RPC?

JSON RPC using Gorilla RPC

Summary

Simplifying RESTful Services with Popular Go Frameworks

Getting the code

go-restful, a framework for REST API creation

CRUD operations and SQLite3 basics

Building a Metro Rail API with go-restful

Building RESTful APIs with the Gin framework

Building a RESTful API with Revel.go

Summary

Working with MongoDB and Go to Create REST APIs

Getting the code

Introduction to MongoDB

Installing MongoDB and using the shell

Introducing mgo, a MongoDB driver for Go

RESTful API with Gorilla Mux and MongoDB

Boosting the querying performance with indexing

Designing an e-commerce data document model

Summary

Working with Protocol Buffers and GRPC

Getting the code

Introduction to protocol buffers

Protocol buffer language

Compiling a protocol buffer with protoc

Introduction to GRPC

Bidirectional streaming with GRPC

Summary

Working with PostgreSQL, JSON, and Go

Getting the code

Installing the PostgreSQL database

pq, a pure PostgreSQL database driver for Go

Implementing a URL shortening service using Postgres and pq

Exploring the JSON store in PostgreSQL

Summary

Building a REST API Client in Go and Unit Testing

Getting the code

Plan for building a REST API client

Basics for writing a command-line tool in Go

grequests – a REST API package for Go

Getting comfortable with the GitHub REST API

Creating a CLI tool as an API client for the GitHub REST API

Using Redis for caching the API data

Creating a unit testing tool for our URL shortening service

Summary

Scaling Our REST API Using Microservices

Getting the code

What are microservices?

Monolith versus microservices

Go Kit, a package for building microservices

Summary

Deploying Our REST services

Getting the code

Installing and configuring Nginx

Monitoring our Go API server with Supervisord

Summary

Using an API Gateway to Monitor and Metricize REST API

Getting the code

Why is an API gateway required?

Kong, an open-source API gateway

Adding API to Kong

API logging in Kong

API authentication in Kong

API rate limiting in Kong

Kong CLI

Other API gateways

Summary

Handling Authentication for Our REST Services

Getting the code

How authentication works

Introducing Postman, a tool for testing REST API

Persisting client sessions with Redis

Introduction to JSON Web Tokens (JWT) and OAuth2

OAuth 2 architecture and basics

Summary

Customer Reviews

5 star

4 star

3 star

2 star

1 star

Building a Metro Rail API with go-restful

Let us use the knowledge we gained in the previous section and create an API for the City Metro Rail project we talked about in the preceding section. The roadmap is as follows:

Design a REST API document.
Create models for a database.
Implement the API logic.

Design specification

Before creating any API, we should know what the specifications of APIs are in the form of a document. We showed a few examples in the previous chapters, including the URL shortener API design document. Let us try to create one for this Metro Rail project. Take a look at the following table:

HTTP verb	Path	Action	Resource
`POST`	`/v1/train` (details as JSON body)	Create	Train
`POST`	`/v1/station` (details as JSON body)	Create	Station
`GET`	`/v1/train/id`	Read	Train
`GET`	`/v1/station/id`	Read	Station
`POST`	`/v1/schedule` (source and destination)	Create	Route

We can also include the UPDATE and DELETE methods. By implementing the preceding design, it will be obvious for users to implement them on their own.

Building RESTful Web services with Go

By : Naren Yellavula

Building RESTful Web services with Go

By: Naren Yellavula

Overview of this book

Related Content you might be interested in

Current Title:

Building RESTful Web services with Go

Go Web Development Cookbook

Building Distributed Applications in Gin

Go Cookbook

Building a Metro Rail API with go-restful

Design specification

Creating...