Why Graceful degradation in Rest API? - Purpose & Use Cases

The Big Idea

What if your API could keep working perfectly even when parts of it break?

The Scenario

Imagine you built a REST API that depends on several external services. When one service goes down, your API just crashes or returns confusing errors to users.

The Problem

Manually checking every service and writing complex error handling everywhere is slow and easy to forget. Users get frustrated when the app suddenly stops working or shows ugly error messages.

The Solution

Graceful degradation lets your API keep working even if some parts fail. It detects problems and falls back to simpler responses or cached data, so users still get useful results without crashes.

Before vs After

✗ Before

if (serviceA.isDown()) {
  return error;
}
return serviceA.getData();

✓ After

try {
  return serviceA.getData();
} catch (error) {
  return cachedData;
}

What It Enables

Graceful degradation makes your API reliable and user-friendly, even when parts of the system fail unexpectedly.

Real Life Example

A weather app API that shows current data when online but falls back to yesterday's forecast if the live service is down, so users always see something helpful.

Key Takeaways

Manual error handling is slow and fragile.

Graceful degradation keeps services running smoothly despite failures.

It improves user experience by providing fallback data or simpler responses.

Practice

1. What is the main goal of graceful degradation in REST APIs?

easy

A. To keep the API working even if some parts fail

B. To stop the API immediately when an error occurs

C. To ignore all errors and continue without response

D. To make the API faster by skipping error checks

Solution

1. Step 1: Understand graceful degradation purpose

   Graceful degradation means the system still works even if some parts fail.

2. Step 2: Compare options with this meaning

   Only To keep the API working even if some parts fail matches this idea by keeping the API working despite failures.

3. Final Answer:

   To keep the API working even if some parts fail -> Option A

4. Quick Check:

   Graceful degradation = keep working despite failure [OK]

Hint: Graceful degradation means continue working despite errors [OK]

Common Mistakes:

• Thinking it stops the API on error
• Assuming errors are ignored without response
• Confusing with performance optimization

2. Which of the following is the correct way to handle errors for graceful degradation in a REST API response (in pseudocode)?

easy

A. ignore errors and return nothing

B. return data; if error then stop

C. try { return data } catch { return fallbackData }

D. throw error without handling

Solution

1. Step 1: Identify error handling syntax

   Graceful degradation uses try-catch to handle errors and provide fallback data.

2. Step 2: Match options to this pattern

   try { return data } catch { return fallbackData } shows try-catch with fallback, others either stop or ignore errors.

3. Final Answer:

   try { return data } catch { return fallbackData } -> Option C

4. Quick Check:

   Use try-catch with fallback for graceful degradation [OK]

Hint: Use try-catch to return fallback on error [OK]

Common Mistakes:

• Not catching errors properly
• Stopping API on first error
• Ignoring fallback responses

3. Consider this pseudocode for a REST API endpoint:

function getUserData() {
  try {
    return fetchUserFromDB();
  } catch (error) {
    return { name: "Guest", id: 0 };
  }
}

What will getUserData() return if the database fetch fails?

medium

A. An error message

B. Nothing, the function crashes

C. Null

D. A default user object with name 'Guest' and id 0

Solution

1. Step 1: Analyze try block behavior

   If fetchUserFromDB() works, it returns user data.

2. Step 2: Analyze catch block fallback

   If an error occurs, catch returns default user object with name 'Guest' and id 0.

3. Final Answer:

   A default user object with name 'Guest' and id 0 -> Option D

4. Quick Check:

   Error fallback returns default user object [OK]

Hint: Catch returns default object on failure [OK]

Common Mistakes:

• Assuming function crashes on error
• Expecting null instead of fallback object
• Thinking error message is returned

4. This REST API code snippet is meant to provide graceful degradation but has a bug:

function getData() {
  try {
    return fetchData();
  } catch (error) {
    fallbackData;
  }
}

What is the problem?

medium

A. The try block is missing

B. The fallback data is not returned in the catch block

C. The function does not catch errors

D. The function returns twice

Solution

1. Step 1: Check catch block code

   The catch block has fallbackData; but does not return it.

2. Step 2: Understand function return behavior

   Without return, the function returns undefined on error, breaking graceful degradation.

3. Final Answer:

   The fallback data is not returned in the catch block -> Option B

4. Quick Check:

   Catch must return fallback data for graceful degradation [OK]

Hint: Always return fallback data inside catch block [OK]

Common Mistakes:

• Forgetting to return fallback data
• Misplacing try-catch blocks
• Assuming catch auto-returns value

5. You have a REST API that fetches user profile and user posts separately. To apply graceful degradation, which approach is best?

hard

A. If fetching posts fails, return profile with empty posts list

B. If fetching posts fails, return error and no profile

C. Stop API if either profile or posts fail

D. Ignore profile and only return posts

Solution

1. Step 1: Understand graceful degradation in multi-part fetch

   It means returning partial data if one part fails, not stopping all.

2. Step 2: Evaluate options for partial fallback

   If fetching posts fails, return profile with empty posts list returns profile and empty posts if posts fail, matching graceful degradation.

3. Final Answer:

   If fetching posts fails, return profile with empty posts list -> Option A

4. Quick Check:

   Partial data returned on failure = graceful degradation [OK]

Hint: Return partial data with fallback for failed parts [OK]

Common Mistakes:

• Stopping API on any failure
• Returning no data if one part fails
• Ignoring fallback for partial data