Sign In Start Free Trial

Book Overview & Buying
Table Of Contents
Feedback & Rating

Python API Development Fundamentals

By : Chan, Ray Chung , Jack Huang

3 (7)

Python API Development Fundamentals

3 (7)

By: Chan, Ray Chung , Jack Huang

Overview of this book

Python is a flexible language that can be used for much more than just script development. By knowing the Python RESTful APIs work, you can build a powerful backend for web applications and mobile applications using Python. You'll take your first steps by building a simple API and learning how the frontend web interface can communicate with the backend. You'll also learn how to serialize and deserialize objects using the marshmallow library. Then, you'll learn how to authenticate and authorize users using Flask-JWT. You'll also learn how to enhance your APIs by adding useful features, such as email, image upload, searching, and pagination. You'll wrap up the whole book by deploying your APIs to the cloud. By the end of this book, you'll have the confidence and skill to leverage the power of RESTful APIs and Python to build efficient web applications.

Preface

Preface

About the Book

Free Chapter

1. Your First Step

1. Your First Step

Introduction

Understanding API

RESTful API

HTTP Protocol

HTTP Methods and CRUD

The JSON Format

HTTP Status Codes

Open API

The Flask Web Framework

Building a Simple Recipe Management Application

Using curl or httpie to Test All the Endpoints

Postman

Summary

2. Starting to Build Our Project

2. Starting to Build Our Project

Introduction

What is Flask-RESTful?

Virtual Environment

Creating a Recipe Model

Configuring Endpoints

Making HTTP Requests to the Flask API using curl and httpie

Summary

3. Manipulating a Database with SQLAlchemy

3. Manipulating a Database with SQLAlchemy

Introduction

Databases

SQL

ORM

Defining Our Models

Password Hashing

Summary

4. Authentication Services and Security with JWT

4. Authentication Services and Security with JWT

Introduction

JWT

Flask-JWT-Extended

Designing the Methods in the Recipe Model

Refresh Tokens

The User Logout Mechanism

Summary

5. Object Serialization with marshmallow

5. Object Serialization with marshmallow

Introduction

Serialization versus Deserialization

marshmallow

A Simple Schema

UserSchema Design

RecipeSchema Design

The PATCH Method

Summary

6. Email Confirmation

6. Email Confirmation

Introduction

Mailgun

User Account Activation Workflow

HTML Format Email

Summary

7. Working with Images

7. Working with Images

Introduction

Building the User Avatar Function

Flask-Uploads

Image Resizing and Compression

Introduction to Pillow

Summary

8. Pagination, Searching, and Ordering

8. Pagination, Searching, and Ordering

Introduction

Pagination

Paginated APIs

Recipe Searching

Sorting and Ordering

Summary

9. Building More Features

9. Building More Features

Introduction

Caching

Flask-Caching

API Rate Limiting

Flask-Limiter

Summary

10. Deployment

10. Deployment

Introduction

Deployment

Comparing SaaS, PaaS, and IaaS

The Heroku Platform

Configuration Handling in Smilecook

Heroku Application

Heroku Add-Ons

Setting Up Environment Variables for the Heroku App

Setting Up Variables in Postman

Setting up the Front-end Interface to Work with the Smilecook API

Summary

Appendix

Appendix

1: Your First Step

2: Starting to Build Our Project

3: Manipulating a Database with SQLAlchemy

4: Authenticated Services and Security with JWTs

5: Validating APIs Using marshmallow

6: Email Confirmations

7: Working with Images

8: Pagination, Searching, and Ordering

9: Building More Features

10: Deployment

Customer Reviews

3 (7)

5 star

14.3%

4 star

14.3%

3 star

28.6%

2 star

42.9%

1 star

0%

HTTP Status Codes

An HTTP status code is a code that is returned in the HTTP protocol. It is usually hidden from users, so you probably didn't realize it exists. In fact, every HTTP response from the server contains a status code. And as we construct our RESTful API, we need to comply with the HTTP protocol. The status code helps the frontend client understand the status of their request, that is, whether it is a success or failure. For example, there could be a client request about creating a record in the backend database. In that case, once the database record has been successfully created, the server should return an HTTP status code 201 (Created). If there is an error (such as a syntax error in the JSON document), the server should return an HTTP status code 400 (Bad Request) instead.

Commonly used HTTP Status Codes

Let's discuss some commonly used status codes. They are as follows:

200 OK means the request has been successful. The request could be a GET, PUT, or PATCH.
201 Created means the POST request has been successful and a record has been created.
204 No Content means the DELETE request has been successful.
400 Bad Request means there is something wrong with the client request. For example, there is a syntax error in the JSON format.
401 Unauthorized means the client request is missing authentication details.
403 Forbidden means the requested resource is forbidden.
404 Not Found means the requested resource doesn't exist.

Visually different images

CONTINUE READING

83

Tech Concepts

36

Programming languages

73

Tech Tools

Unlimited access to the largest independent learning library in tech of over 8,000 expert-authored tech books and videos.

Innovative learning tools, including AI book assistants, code context explainers, and text-to-speech.

50+ new titles added per month and exclusive early access to books as they are being written.

Python API Development Fundamentals

Search

Your notes and bookmarks