Why APIs matter in Flask - Challenge Your Understanding

Challenge - 5 Problems

🧠 Conceptual

intermediate

Why do APIs help developers?

Which of the following best explains why APIs are important for developers when building web applications?

A APIs allow different software to communicate and share data easily, speeding up development.

B APIs automatically fix bugs in your code without any extra work.

C APIs replace the need for databases in web applications.

D APIs make your application run faster by using less memory.

💡 Hint

Think about how different programs or services work together.

APIs act like bridges that let different software talk to each other, making it easier and faster to build features without starting from scratch.

❓ component_behavior

intermediate

What does this Flask API endpoint return?

Given this Flask code, what will the API return when accessed at '/hello'?

Flask

from flask import Flask, jsonify
app = Flask(__name__)

@app.route('/hello')
def hello():
    return jsonify({'message': 'Hello, world!'})

A {"message": "Hello, world!"}

B Hello, world!

C <html><body>Hello, world!</body></html>

D Error: Route not found

💡 Hint

Look at the return type and what jsonify does.

The jsonify function converts the dictionary into a JSON response, so the API returns a JSON string with the message.

📝 Syntax

advanced

Identify the syntax error in this Flask route

What error will this Flask code produce?

Flask

from flask import Flask
app = Flask(__name__)

@app.route('/data')
def data():
    return {'data': 123}

A No error, runs successfully

B IndentationError: expected an indented block

C NameError: name 'data' is not defined

D TypeError: 'dict' object is not callable

💡 Hint

Check the indentation of the function body.

The return statement is not indented inside the function, causing an IndentationError.

❓ state_output

advanced

What is the output of this Flask API with state?

Consider this Flask app code. What will the API return after two calls to '/count'?

Flask

from flask import Flask, jsonify
app = Flask(__name__)
count = 0

@app.route('/count')
def count_route():
    global count
    count += 1
    return jsonify({'count': count})

A {"count": 0}

B {"count": 1}

C Error: global variable not allowed

D {"count": 2}

💡 Hint

Think about how the global variable changes with each call.

Each call increases the count by 1. After two calls, count is 2, so the API returns {'count': 2}.

🔧 Debug

expert

Why does this Flask API return a 405 Method Not Allowed error?

This Flask route is defined as: @app.route('/submit', methods=['POST']) def submit(): return 'Submitted!' What happens if you try to access '/submit' with a browser GET request?

A The server returns 'Submitted!' even with a GET request.

B The server returns a 404 Not Found error.

C The server returns a 405 Method Not Allowed error because GET is not allowed.

D The server crashes with an internal error.

💡 Hint

Check the allowed HTTP methods for the route.

The route only accepts POST requests. A GET request is not allowed, so Flask returns a 405 error.

Practice

1. Why are APIs important when building web applications with Flask?

easy

A. They automatically create user interfaces.

B. They allow different apps to share data and features easily.

C. They make the app run faster on the server.

D. They replace the need for a database.

Solution

1. Step 1: Understand the role of APIs in app communication

   APIs let different software talk to each other by sharing data and features.

2. Step 2: Relate this to Flask's use of APIs

   Flask helps build APIs that send and receive data, enabling app interaction.

3. Final Answer:

   They allow different apps to share data and features easily. -> Option B

4. Quick Check:

   APIs enable app communication = C [OK]

Hint: APIs connect apps by sharing data and features [OK]

Common Mistakes:

• Thinking APIs speed up server processing
• Believing APIs create user interfaces automatically
• Assuming APIs replace databases

2. Which Flask code snippet correctly defines a simple API route that returns JSON data?

easy

A. @app.route('/data')\ndef get_data():\n return {'key': 'value'}

B. app.route('/data')\ndef get_data():\n return {'key': 'value'}

C. @app.route('/data')\ndef get_data():\n print({'key': 'value'})

D. app.route('/data')\ndef get_data():\n print({'key': 'value'})

Solution

1. Step 1: Identify correct Flask route decorator syntax

   Flask routes require the '@app.route' decorator before the function.

2. Step 2: Check the function returns JSON data properly

   The function should return a dictionary (Flask converts it to JSON), not print it.

3. Final Answer:

   @app.route('/data')\ndef get_data():\n return {'key': 'value'} -> Option A

4. Quick Check:

   Correct decorator and return = B [OK]

Hint: Use @app.route and return data, not print [OK]

Common Mistakes:

• Missing '@' before app.route
• Using print instead of return
• Not returning data from the function

3. What will be the output when accessing the Flask API route defined below?

@app.route('/hello')
def hello():
    return {'message': 'Hi there!'}

medium

A. A server error because return type is wrong

B. A plain text response: Hi there!

C. A JSON response: {"message": "Hi there!"}

D. An HTML page with the text 'Hi there!'

Solution

1. Step 1: Understand Flask's automatic JSON conversion

   Returning a dictionary from a route makes Flask send JSON response automatically.

2. Step 2: Check the returned dictionary content

   The dictionary has key 'message' with value 'Hi there!', so JSON will reflect that.

3. Final Answer:

   A JSON response: {"message": "Hi there!"} -> Option C

4. Quick Check:

   Return dict = JSON response = A [OK]

Hint: Return dict from route to get JSON response [OK]

Common Mistakes:

• Expecting plain text instead of JSON
• Thinking Flask returns HTML automatically
• Assuming a server error from dict return

4. Identify the error in this Flask API code snippet:

@app.route('/data', methods=['POST'])
def data():
    data = request.get_json
    return {'received': data}

medium

A. Flask routes cannot accept JSON data.

B. The route should use GET method instead of POST.

C. The return statement should use print instead of return.

D. request.get_json() is missing parentheses, so data is a method, not JSON.

Solution

1. Step 1: Check how request.get_json is used

   request.get_json is a method and must be called with parentheses to get JSON data.

2. Step 2: Understand the impact of missing parentheses

   Without (), data is a method object, not the JSON content, causing wrong output.

3. Final Answer:

   request.get_json() is missing parentheses, so data is a method, not JSON. -> Option D

4. Quick Check:

   Call get_json() method properly = D [OK]

Hint: Always call get_json() with parentheses [OK]

Common Mistakes:

• Forgetting parentheses on get_json
• Using wrong HTTP method for route
• Using print instead of return in route

5. You want to create a Flask API that accepts a POST request with JSON containing a user's name and returns a greeting. Which code correctly implements this?

hard

A. @app.route('/greet', methods=['POST'])\ndef greet():\n data = request.get_json()\n name = data.get('name', 'Guest')\n return {'greeting': f'Hello, {name}!'}

B. @app.route('/greet')\ndef greet():\n name = request.args.get('name')\n return {'greeting': f'Hello, {name}!'}

C. @app.route('/greet', methods=['GET'])\ndef greet():\n data = request.get_json()\n return {'greeting': 'Hello!'}

D. @app.route('/greet', methods=['POST'])\ndef greet():\n name = request.form['name']\n return {'greeting': f'Hello, {name}!'}

Solution

1. Step 1: Check the HTTP method and route setup

   The API must accept POST requests, so methods=['POST'] is correct.

2. Step 2: Verify JSON data extraction and greeting creation

   Using request.get_json() gets JSON data; then safely get 'name' with default 'Guest'.

3. Step 3: Confirm the returned JSON greeting format

   Return a dictionary with the greeting message using an f-string for the name.

4. Final Answer:

   Correct POST route with JSON input and greeting response. -> Option A

5. Quick Check:

   POST + get_json() + return greeting = A [OK]

Hint: Use POST method and request.get_json() to read JSON data [OK]

Common Mistakes:

• Using GET instead of POST for JSON input
• Trying to get JSON data from request.args or form
• Not handling missing 'name' key safely