Nested resources in Rest API - Step-by-Step Execution

Concept Flow - Nested resources

Client sends request to nested resource URL

↓

Server parses URL to identify parent resource

↓

Server parses URL to identify nested child resource

↓

Server fetches parent resource data

↓

Server fetches nested child resource data linked to parent

↓

Server sends combined nested resource response

↓

Client receives nested data

The client requests a nested resource by URL, the server identifies parent and child resources, fetches data accordingly, and returns the nested data.

Execution Sample

Rest API

GET /users/42/posts/7

Response:
{
  "userId": 42,
  "postId": 7,
  "title": "Hello World"
}

This request fetches post 7 belonging to user 42, showing nested resource access.

Execution Table

Step	Action	URL Part Parsed	Resource Identified	Data Fetched	Response Part
1	Receive request	/users/42/posts/7	Identify 'users' and ID 42	User data for ID 42	User info included
2	Parse nested part	/posts/7	Identify 'posts' and ID 7 under user 42	Post data for ID 7 linked to user 42	Post info included
3	Combine data	N/A	N/A	User and post data combined	Full nested resource response
4	Send response	N/A	N/A	N/A	Response sent to client

💡 Request fully processed; nested resource data sent in response.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	Final
request_url	/users/42/posts/7	/users/42/posts/7	/users/42/posts/7	/users/42/posts/7	/users/42/posts/7
parent_resource	None	users (ID 42)	users (ID 42)	users (ID 42)	users (ID 42)
child_resource	None	None	posts (ID 7)	posts (ID 7)	posts (ID 7)
user_data	None	Fetched user 42 data	Fetched user 42 data	Fetched user 42 data	Fetched user 42 data
post_data	None	None	Fetched post 7 data linked to user 42	Fetched post 7 data linked to user 42	Fetched post 7 data linked to user 42
response	Empty	Empty	Empty	Combined user and post data	Sent to client

Key Moments - 3 Insights

Why do we need to parse the URL in parts for nested resources?

Because the URL contains both the parent and child resource identifiers, parsing in parts lets the server find the correct parent first, then the child linked to it, as shown in steps 1 and 2 of the execution_table.

What happens if the child resource ID does not belong to the parent resource?

The server will not find matching child data linked to the parent, so it will usually return an error or empty response. This is implied in step 2 where the server fetches post data linked to user 42.

Why combine data before sending the response?

Combining data ensures the client gets a complete nested resource view in one response, as shown in step 3 where user and post data are combined before sending.

Visual Quiz - 3 Questions

Look at the execution_table, what resource is identified at Step 1?

A Both user and post

B Post with ID 7

C User with ID 42

D No resource identified yet

💡 Hint

Check the 'Resource Identified' column at Step 1 in the execution_table.

At which step does the server fetch the nested child resource data?

A Step 1

B Step 2

C Step 3

D Step 4

💡 Hint

Look at the 'Data Fetched' column in the execution_table for when post data is fetched.

If the URL was /users/42/posts, what would change in the execution_table?

A No child resource ID parsed at Step 2

B Parent resource would be different

C Response would include only post 7

D Server would skip Step 1

💡 Hint

Consider how the 'URL Part Parsed' and 'Resource Identified' columns change when no child ID is present.

Concept Snapshot

Nested resources use URLs that include parent and child IDs.
The server parses the URL step-by-step to find parent then child.
It fetches data linked by these IDs.
Response combines nested data for client.
Example: GET /users/42/posts/7 fetches post 7 of user 42.

Full Transcript

Nested resources in REST APIs mean accessing a resource that belongs to another resource, like posts of a user. The client sends a request with a URL showing both parent and child IDs. The server reads the URL, first finds the parent resource (user 42), then the nested child resource (post 7). It fetches data for both and sends a combined response. This step-by-step parsing and data fetching ensures the client gets the correct nested data. If the child resource does not belong to the parent, the server returns an error or empty data. This process helps organize related data clearly in APIs.

Practice

1. What is the main purpose of using nested resources in a REST API?

easy

A. To make URLs shorter and simpler

B. To show how one resource belongs inside another resource

C. To avoid using IDs in URLs

D. To separate unrelated data into different APIs

Solution

1. Step 1: Understand nested resources concept

   Nested resources organize data by showing relationships, like a comment inside a post.

2. Step 2: Identify the purpose of nesting

   Nesting clarifies that one resource belongs to another, helping API users find related data easily.

3. Final Answer:

   To show how one resource belongs inside another resource -> Option B

4. Quick Check:

   Nested resources = parent-child relationship [OK]

Hint: Nested URLs show parent-child links clearly [OK]

Common Mistakes:

• Thinking nested resources make URLs shorter
• Believing IDs are not needed in nested URLs
• Confusing unrelated data separation with nesting

2. Which of the following is the correct nested URL format to get comments of a post with ID 5?

easy

A. /comments/5/posts

B. /comments/posts/5

C. /posts/5/comments

D. /posts/comments/5

Solution

1. Step 1: Identify parent and child in URL

   The parent is 'posts' with ID 5, and the child is 'comments'. The child comes after the parent.

2. Step 2: Check URL structure

   The correct format is /parent/{parent_id}/child, so /posts/5/comments is correct.

3. Final Answer:

   /posts/5/comments -> Option C

4. Quick Check:

   Parent ID before child resource [OK]

Hint: Parent resource and ID come before child resource in URL [OK]

Common Mistakes:

• Placing child resource before parent
• Swapping IDs and resource names
• Using incorrect order of URL segments

3. Given the nested URL /users/10/orders/3, what resource does this URL represent?

medium

A. Order with ID 3 belonging to user with ID 10

B. User with ID 3 who placed order 10

C. All orders of user 10 and order 3 combined

D. User 10's profile and order 3 details merged

Solution

1. Step 1: Analyze URL segments

   The URL shows 'users' with ID 10, then 'orders' with ID 3 nested inside.

2. Step 2: Understand resource relationship

   This means order 3 belongs to user 10, so the URL points to that specific order.

3. Final Answer:

   Order with ID 3 belonging to user with ID 10 -> Option A

4. Quick Check:

   Nested resource = child inside parent [OK]

Hint: Read URL left to right: parent then child with IDs [OK]

Common Mistakes:

• Mixing up which ID belongs to user or order
• Thinking URL shows combined or merged data
• Ignoring the order of resources in URL

4. You have this nested route defined: /projects/{projectId}/tasks/{taskId}. Which URL is incorrect to get task 7 of project 2?

medium

A. /projects/2/tasks/7/

B. /projects/2/tasks/7

C. /projects/2/tasks/07

D. /tasks/7/projects/2

Solution

1. Step 1: Check correct nested URL format

   The correct format is /projects/{projectId}/tasks/{taskId}, so project ID comes before task ID.

2. Step 2: Identify incorrect URL

   /tasks/7/projects/2 reverses the order to /tasks/7/projects/2, which breaks nesting rules.

3. Final Answer:

   /tasks/7/projects/2 -> Option D

4. Quick Check:

   Parent resource must come before child in URL [OK]

Hint: Parent resource always precedes child resource in nested URLs [OK]

Common Mistakes:

• Swapping parent and child in URL
• Adding trailing slashes incorrectly
• Using leading zeros in IDs (usually allowed but check API)

5. You want to design a REST API for a blog where each post has multiple comments, and each comment can have multiple replies. Which nested URL correctly accesses reply 4 of comment 2 on post 10?

hard

A. /posts/10/comments/2/replies/4

B. /posts/10/replies/4/comments/2

C. /comments/2/posts/10/replies/4

D. /posts/10/comments/replies/4/2

Solution

1. Step 1: Understand the resource hierarchy

   Post is the top parent, comments belong to posts, and replies belong to comments.

2. Step 2: Build nested URL from parent to child

   The URL should list post ID, then comment ID, then reply ID in order: /posts/10/comments/2/replies/4.

3. Final Answer:

   /posts/10/comments/2/replies/4 -> Option A

4. Quick Check:

   Nested URL = parent -> child -> grandchild [OK]

Hint: List resources from top parent to deepest child in URL [OK]

Common Mistakes:

• Mixing order of nested resources
• Skipping intermediate resource IDs
• Placing child before parent in URL