API key authentication in Rest API - Mini Project: Build & Apply

API Key Authentication

📖 Scenario: You are building a simple REST API that requires users to provide an API key to access protected data. This is a common way to control who can use your API.

🎯 Goal: Create a basic API endpoint that checks for a valid API key sent in the request headers. If the key is correct, the API returns a success message. If not, it returns an error message.

📋 What You'll Learn

Create a variable to store the valid API key.

Check the request headers for the API key.

Compare the provided key with the valid key.

Return a success message if the key matches.

Return an error message if the key is missing or incorrect.

💡 Why This Matters

🌍 Real World

API key authentication is used to protect APIs from unauthorized access by requiring a secret key.

💼 Career

Understanding API key authentication is important for backend developers and anyone working with web services and security.

1

Set up the valid API key

Create a variable called VALID_API_KEY and set it to the string "12345abcde".

Rest API

# Your code here

Hint

Think of the API key as a secret password stored in a variable.

2

Get the API key from request headers

Create a variable called provided_key that gets the value of the "X-API-Key" header from the request.headers dictionary.

Rest API

VALID_API_KEY = "12345abcde"
# Your code here

Hint

Use the get method on request.headers to safely get the API key.

3

Check if the API key is valid

Write an if statement that compares provided_key with VALID_API_KEY. If they are equal, set a variable response to "Access granted". Otherwise, set response to "Access denied".

Rest API

VALID_API_KEY = "12345abcde"
provided_key = request.headers.get("X-API-Key")
# Your code here

Hint

Use a simple if-else to compare the keys and set the response message.

4

Return the response message

Write a line to return or print the response variable so the API sends the message back to the user.

Rest API

VALID_API_KEY = "12345abcde"
provided_key = request.headers.get("X-API-Key")
if provided_key == VALID_API_KEY:
    response = "Access granted"
else:
    response = "Access denied"
# Your code here

Hint

Use print(response) to show the message.

Practice

1. What is the main purpose of an API key in API key authentication?

easy

A. To store user passwords securely

B. To encrypt the data sent between client and server

C. To control and restrict access to the API

D. To speed up the API response time

Solution

1. Step 1: Understand the role of API keys

   API keys are used to identify and authorize clients accessing an API.

2. Step 2: Differentiate from other security methods

   API keys do not encrypt data or store passwords; they control access.

3. Final Answer:

   To control and restrict access to the API -> Option C

4. Quick Check:

   API key = Access control [OK]

Hint: API keys control who can use the API, not data encryption [OK]

Common Mistakes:

• Confusing API keys with encryption keys
• Thinking API keys store user passwords
• Assuming API keys improve speed

2. Which of the following is the correct way to send an API key in an HTTP request header?

easy

A. Key: YOUR_API_KEY

B. Api-Key: YOUR_API_KEY

C. Authorization: Bearer YOUR_API_KEY

D. X-API-KEY: YOUR_API_KEY

Solution

1. Step 1: Identify common header names for API keys

   Many APIs use the header 'X-API-KEY' to send the API key securely.

2. Step 2: Differentiate from other header formats

   'Authorization: Bearer' is for tokens, not API keys; 'Api-Key' and 'Key' are less standard.

3. Final Answer:

   X-API-KEY: YOUR_API_KEY -> Option D

4. Quick Check:

   Standard header = X-API-KEY [OK]

Hint: API keys usually go in 'X-API-KEY' header [OK]

Common Mistakes:

• Using 'Authorization: Bearer' for API keys
• Sending API key as 'Key' header
• Confusing API key with OAuth token

3. Consider this Python code snippet using the requests library to call an API with an API key:

import requests
headers = {"X-API-KEY": "12345"}
response = requests.get("https://api.example.com/data", headers=headers)
print(response.status_code)

What will this code print if the API key is valid and the request succeeds?

medium

A. 401

B. 200

C. 404

D. 500

Solution

1. Step 1: Understand HTTP status codes

   200 means success, 401 means unauthorized, 404 means not found, 500 means server error.

2. Step 2: Analyze the code behavior with valid API key

   With a valid API key, the server should authorize the request and respond with 200.

3. Final Answer:

   200 -> Option B

4. Quick Check:

   Valid key = 200 OK [OK]

Hint: Valid API key means HTTP 200 success code [OK]

Common Mistakes:

• Confusing 401 Unauthorized with success
• Assuming 404 means invalid key
• Thinking 500 is related to API key

4. You have this code snippet to send an API key in a URL parameter:

import requests
url = "https://api.example.com/data?api_key=12345"
response = requests.get(url)
print(response.status_code)

The server always returns 401 Unauthorized. What is the most likely problem?

medium

A. The API key value is incorrect

B. The URL is missing HTTPS

C. The API key should be sent in headers, not URL parameters

D. The requests library does not support URL parameters

Solution

1. Step 1: Check if sending API key in URL is allowed

   Many APIs accept API keys in URL parameters, so this is often valid.

2. Step 2: Consider the 401 Unauthorized response

   401 usually means invalid or missing credentials, so the key value is likely wrong.

3. Final Answer:

   The API key value is incorrect -> Option A

4. Quick Check:

   401 = Invalid credentials [OK]

Hint: 401 usually means wrong or missing API key value [OK]

Common Mistakes:

• Assuming URL parameters never work for API keys
• Ignoring that 401 means invalid credentials
• Thinking requests library can't send URL parameters

5. You want to secure your API by rotating API keys regularly. Which approach best ensures security while allowing clients to continue using the API without interruption?

hard

A. Generate a new key, distribute it, then disable the old key after a grace period

B. Generate a new key and immediately disable the old key

C. Keep using the same key indefinitely to avoid client issues

D. Send the API key in the URL to make it easier to update

Solution

1. Step 1: Understand key rotation best practices

   Rotating keys means replacing old keys with new ones to improve security.

2. Step 2: Ensure clients have time to update keys

   Disabling old keys immediately can break clients; a grace period avoids this.

3. Final Answer:

   Generate a new key, distribute it, then disable the old key after a grace period -> Option A

4. Quick Check:

   Grace period = smooth key rotation [OK]

Hint: Use grace period when rotating keys to avoid downtime [OK]

Common Mistakes:

• Disabling old key immediately causing client failures
• Never rotating keys risking security
• Sending keys in URL exposing them