Why REST API for IoT device in Raspberry Pi? - Purpose & Use Cases

The Big Idea

What if you could control all your smart devices with just a few simple commands from anywhere?

The Scenario

Imagine you have many smart devices at home, like lights, sensors, and cameras. You want to control them all from your phone or computer. Without a REST API, you would have to connect to each device separately, using different methods and commands, which is confusing and slow.

The Problem

Manually managing each device means writing different code for each one, remembering many commands, and dealing with errors when devices don't respond. It's like trying to talk to many people at once, each speaking a different language. This makes controlling devices slow and frustrating.

The Solution

A REST API creates a simple, common language for all your devices. You can send easy commands over the internet, like asking a device to turn on or send data. This way, all devices understand the same requests, making control fast, reliable, and easy to automate.

Before vs After

✗ Before

connect_to_device(ip)
send_command('turn_on')
read_response()

✓ After

GET /device/light1/on
POST /device/sensor1/data

What It Enables

With a REST API, you can control and monitor all your IoT devices from anywhere, using simple web requests that work the same way for every device.

Real Life Example

Imagine you are away from home and want to check if your garden lights are on or turn them off. Using a REST API, your phone app sends a quick request to your Raspberry Pi controlling the lights, and you get instant control without complicated setup.

Key Takeaways

Manual control of many devices is slow and error-prone.

REST API gives a simple, unified way to communicate with all devices.

This makes remote control and automation easy and reliable.

Practice

1. What is the main purpose of a REST API on a Raspberry Pi IoT device?

easy

A. To connect the Raspberry Pi to a monitor

B. To allow remote communication and control over the network

C. To store large amounts of data locally

D. To increase the Raspberry Pi's processing speed

Solution

1. Step 1: Understand REST API role

   A REST API enables devices to communicate over a network using standard web protocols.

2. Step 2: Identify IoT device needs

   IoT devices use REST APIs to send sensor data or receive commands remotely.

3. Final Answer:

   To allow remote communication and control over the network -> Option B

4. Quick Check:

   REST API = Remote communication [OK]

Hint: REST APIs enable network communication for IoT devices [OK]

Common Mistakes:

• Confusing REST API with hardware speed
• Thinking REST API stores data locally
• Assuming REST API connects to display devices

2. Which Python library is commonly used on Raspberry Pi to create a REST API for IoT devices?

easy

A. Flask

B. NumPy

C. Pandas

D. Matplotlib

Solution

1. Step 1: Identify common Python libraries

   NumPy, Pandas, and Matplotlib are for data processing and visualization, not REST APIs.

2. Step 2: Recognize Flask's role

   Flask is a lightweight web framework used to build REST APIs easily on Raspberry Pi.

3. Final Answer:

   Flask -> Option A

4. Quick Check:

   Flask = REST API framework [OK]

Hint: Flask is the go-to Python web framework for REST APIs [OK]

Common Mistakes:

• Choosing data libraries instead of web frameworks
• Confusing Flask with data analysis tools
• Assuming Matplotlib creates APIs

3. What will be the output of this Flask route code on a Raspberry Pi?

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

@app.route('/sensor')
def sensor():
    data = {'temperature': 22, 'humidity': 60}
    return jsonify(data)

# Assume app is running and /sensor is requested

medium

A. {"temperature": 22, "humidity": 60}

B. temperature=22, humidity=60

C. temperature: 22, humidity: 60

D. Error: jsonify not defined

Solution

1. Step 1: Understand jsonify function

   jsonify converts Python dict to JSON string with correct headers for API response.

2. Step 2: Analyze route output

   The route returns JSON with keys 'temperature' and 'humidity' and their values.

3. Final Answer:

   {"temperature": 22, "humidity": 60} -> Option A

4. Quick Check:

   jsonify(dict) = JSON string [OK]

Hint: jsonify returns JSON string from dict in Flask [OK]

Common Mistakes:

• Expecting plain text instead of JSON
• Confusing jsonify with HTML output
• Missing import of jsonify causing errors

4. Identify the error in this Flask route code for Raspberry Pi IoT device:

from flask import Flask
app = Flask(__name__)

@app.route('/led/on')
def led_on():
    GPIO.output(17, True)
    return 'LED is ON'

medium

A. Return statement must be JSON, not string

B. Route decorator syntax is incorrect

C. Missing import and setup for GPIO module

D. Flask app is not created properly

Solution

1. Step 1: Check GPIO usage

   GPIO module must be imported and configured before use to control pins.

2. Step 2: Verify code completeness

   Code lacks 'import RPi.GPIO as GPIO' and GPIO setup like GPIO.setmode() and GPIO.setup().

3. Final Answer:

   Missing import and setup for GPIO module -> Option C

4. Quick Check:

   GPIO needs import and setup before use [OK]

Hint: Always import and setup GPIO before controlling pins [OK]

Common Mistakes:

• Assuming Flask route syntax is wrong
• Thinking return must be JSON always
• Ignoring GPIO initialization steps

5. You want to create a REST API on Raspberry Pi that returns sensor data only if temperature is above 25°C. Which code snippet correctly implements this logic using Flask?

hard

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

@app.route('/sensor')
def sensor():
temp = 30
if temp >= 25:
return {'temperature': temp}
else:
return {'message': 'Temperature too low'}

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

@app.route('/sensor')
def sensor():
temp = 20
if temp < 25:
return jsonify({'temperature': temp})
else:
return jsonify({'message': 'Temperature too low'})

C. from flask import Flask
app = Flask(__name__)

@app.route('/sensor')
def sensor():
temp = 30
if temp > 25:
return {'temperature': temp}
else:
return {'message': 'Temperature too low'}

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

@app.route('/sensor')
def sensor():
temp = 30
if temp > 25:
return jsonify({'temperature': temp})
else:
return jsonify({'message': 'Temperature too low'})

Solution

1. Step 1: Check temperature condition logic

   We want to return data only if temperature is above 25, so 'temp > 25' is correct.

2. Step 2: Verify response format

   Flask needs jsonify to return proper JSON response with correct headers.

3. Final Answer:

   Code with temp=30, condition temp > 25, and jsonify responses -> Option D

4. Quick Check:

   Use temp > 25 and jsonify for JSON response [OK]

Hint: Use if temp > 25 and jsonify() to return JSON [OK]

Common Mistakes:

• Using wrong temperature comparison operator
• Returning dict without jsonify causing errors
• Setting temperature below threshold incorrectly