REST API Design from Scratch

Name: REST API Design from Scratch
Rating: 4.3 (724 reviews)

API | REST API | REST Framework | API Design | Python Flask Essentials

Role Play

Created byPraveenkumar Bouna

Last updated 8/2025

English

What you'll learn

Overview of RESTful APIs and its benefits. You will learn about RESTful API from scratch. You will know why you need to design an API.
Understanding the structure of a professionally written API. You will grasp the structure of it and become an expert in designing an API.
Step-by-step instructions for designing a RESTful API. You will learn to design a new API from scratch.
Design API resources and associations between them. Know how to design the resource including naming convention, relationship between APIs, etc.
Designing API operations. Master the ideal usage of HTTP GET, POST, PUT, DELETE, and PATCH operations.
Design the API requests and responses for each of the common HTTP operations. Includes designing error message formats to follow in your projects.
Designing for filtering, pagination, and sorting.
Design API versioning methods that you can employ to track the changes you make to the APIs.
Lots of Downloadable PDFs: Designing RESTful API Quick Guide, HTTP Status Codes Cheat Sheet.
Practice assignments to apply your learning from this course. You will feel comfortable starting working on real-life projects.

Course content

12 sections • 95 lectures • 5h 15m total length

Welcome & About This Course2:55
You have taken the right decision by choosing this course to get started with OpenAPI! At the end of this lecture, you will have a good overview of how this course is organized and what to expect out of this course.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch", a guide to design web APIs that follows REST principles using a step-by-step approach.
Download: Designing RESTful API Quick Guide0:18
Download the Designing RESTful API Quick Guide that you can use as a reference while designing an API.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Download: RESTful API Design Document Template0:15
Download the RESTful API Design Document that will be built throughout this course.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Download: Postman Collection File0:31
Join the Discord Community0:11
Join the official students’ Facebook group to get even more feedback and support!
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch", a guide to design web APIs that follows REST principles using a step-by-step approach.

Introduction0:52
A quick overview of the topics you will learn in this section.
What is API?2:45
Know what is API and the part they play in the communication between client and server.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Why Should You Design API?3:50
Understand the key reasons behind why you should design APIs before implementing them.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Step 1: Create a New API4:45
1st step in designing a RESTful API from scratch.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Types of API3:54
Get to know the different types of API available and when each of them are applied while designing a REST API.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Step 2: Identify the Type of API1:14
2nd step in designing a RESTful API from scratch.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Should You Change the Existing API Design?2:59
What to be done when working on an existing API? Should you change its design or go with the flow?
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Getting Started with Designing APIs
Making the Case for API-First Design
Summary1:56
A quick recap of the topics you learned in this section and what is coming up next.

Introduction1:46
A quick overview of the topics you will learn in this section.
How HTTP Works?3:19
Know how a basic HTTP request-response cycle works.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Parts of a HTTP Request7:16
Understand the different parts of a typical HTTP request between client and the server.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Demo: Parts of a HTTP Request4:49
Get hands-on about the different parts of a HTTP request.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
What is REST?4:12
Understand what is the REST principle all about along with its need, usage and application.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Demo: API in Postman8:18
Get hands-on about the API usage in the Postman tool used for designing APIs.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
URL vs URI3:22
Understand the difference between URL and URI while designing APIs.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Step 3: Identify the Server Base URL3:06
3rd step in designing a RESTful API from scratch - identify the server base URL for your REST API.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Overview of RESTful APIs
Summary2:50
A quick recap of the topics you learned in this section and what is coming up next.

Introduction1:46
A quick overview of the topics you will learn in this section.
Resources should be Nouns3:31
Know why the resources should be designed as nouns.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Step 4: Identify the Resources1:44
4th step in designing a RESTful API from scratch - identify the resources for your REST API.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Resources should be Collections4:03
Know why the resources should be designed as collections as part of REST API design.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Step 5: Have the Resources as Plural2:04
5th step in designing a RESTful API from scratch - make sure to have your resources in plural form.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Step 6: Define the Resource Models2:50
6th step in designing a RESTful API from scratch - brainstorm and define the resource models for your REST APIs.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Use Unique Identifiers1:51
Get to know why and how to select the unique identifier for each of your resource models.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Step 7: Select the Identifier for Each Resource2:04
7th step in designing a RESTful API from scratch - narrow down and select an identifier for each resource while designing API..
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Non-resource Data should be Query Parameters2:51
Know why the non-resource data should not be made as part of resource models; instead should be query parameters while designing API.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Designing API Resources
Summary2:20
A quick recap of the topics you learned in this section and what is coming up next.

Introduction1:30
A quick overview of the topics you will learn in this section.
Defining Relationships between Resources5:07
Find out the relationship between resources and their importance while designing APIs.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Step 8: Identify the Association for Each Resource3:37
8th step in designing a RESTful API from scratch - find the associations between resources (if any).
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
URL Shouldn’t be Complex4:42
Learn the recommended URL structure along with tips on designing better URLs in APIs.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Step 9: Check for the URL Complexity3:09
9th step in designing a RESTful API from scratch - validate whether the URLs are as per the recommended guideline.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Combine Related Resources4:05
Understand how you can combine related resources to reduce the number of URL endpoints you expose to the client.
This lecture is part of the course "Designing RESTful APIs: Learn to Design API from Scratch”, a guide to design web APIs that follows REST principles using a step-by-step approach.
Designing Associations between Resources
Summary2:35
A quick recap of the topics you learned in this section and what is coming up next.

Introduction2:40
HTTP Status Codes7:11
Designing Status Codes in Responses5:01
Step 14: Identify the HTTP Status Codes for the Operation9:31
Choosing the Format of Responses3:46
Step 15: Identify the Content Type of Response for the Operation2:48
Designing Response Body3:24
Step 16: Identify the Response Body for the Operation17:16
Designing Error Handling7:36
Step 17: Handle Errors for the Operation1:29
Designing API Responses
Summary3:10

Introduction1:53
Why you Should Version APIs?3:59
Ways to Version APIs1:28
Approach 1: No versioning4:20
Approach 2: URL Versioning8:52
Approach 3: Query String Versioning7:40
Approach 4: Header Versioning5:18
Approach 5: Media Type Versioning2:34
Which Versioning Approach to Use?3:04
Step 21: Identify the API Versioning Scheme and Set the API Version2:51
Navigating API Versioning Strategy for Partner Integration
Summary4:42

Requirements

Basic knowledge of APIs will be helpful.

Description

The usage of API has dramatically increased in recent times, especially for cloud-native applications. Microservices have become mainstream and expose their services through API endpoints. You will learn how to design an API based on the requirements through a step-by-step approach. I've also included the companion sheets you can use whenever you need to create an API at your work.

Instructor Bio:

I am a software engineer with over 15 years of experience in the industry. I have worked on various projects and gained a wealth of knowledge and expertise in cloud computing. I am an experienced online course instructor who has trained many students on various software development topics, including API, .NET, Docker, Kubernetes, and Azure.

Topics Covered In This Course:

Overview of RESTful APIs and their benefits.
Understand the structure of a professionally written API.
Step-by-step instructions for designing a RESTful API.
Design RESTful API resources and associations between them.
Design RESTful API operations.
Design API requests and responses for each of the standard HTTP operations.
Design for filtering, pagination, and sorting.
Design API versioning methods that you can employ to track the changes you make to the APIs.
Lots of Downloadable PDFs: Designing RESTful API Quick Guide, HTTP Status Codes Cheat Sheet, etc
Practice assignments to apply what you learned.

By The End Of This Course:

You will know how to design a RESTful API from scratch.
You can design and write down each API element clearly and professionally.

Enroll now and start your journey for a successful API and cloud computing career.

Who this course is for:

API Developers, beginner or experienced, who work with APIs. You are involved in either design or development of web services. This course will provide you with a strong foundation for RESTful design concepts for API development.

REST API Design from Scratch

What you'll learn

Explore related topics

Course content

Course Introduction5 lectures • 4min

Getting Started with Designing REST APIs9 lectures • 22min

Overview of RESTful APIs9 lectures • 39min

Designing API Resources10 lectures • 25min

Designing Associations between Resources7 lectures • 25min

Designing API Operations8 lectures • 31min

Designing API Requests7 lectures • 26min

Designing API Responses11 lectures • 1hr 4min

Design for Filtering, Pagination, and Sorting8 lectures • 25min

Designing API Versions12 lectures • 47min

Requirements

Description

Who this course is for: