422 Unprocessable Entity in Rest API - Mini Project: Build & Apply

Handling 422 Unprocessable Entity in REST API

📖 Scenario: You are building a simple REST API that accepts user data. Sometimes users send data that looks correct but has errors, like missing required fields or wrong formats. The server should respond with a 422 Unprocessable Entity status to tell the user their data needs fixing.

🎯 Goal: Build a small REST API endpoint that checks incoming JSON data for required fields and returns a 422 error with a helpful message if the data is invalid.

📋 What You'll Learn

Create a Flask app with one POST endpoint /users

Check if the JSON data has a name field

If name is missing, respond with status 422 and a JSON error message

If name is present, respond with status 200 and a success message

💡 Why This Matters

🌍 Real World

APIs often need to tell users when their data is wrong but well-formed. Using 422 status helps users fix their input.

💼 Career

Backend developers and API designers must handle input validation and return correct HTTP status codes to build reliable services.

1

Set up Flask app and import modules

Write code to import Flask and request from flask, then create a Flask app called app.

Rest API

# Your code here

Need a hint?

Use from flask import Flask, request and then app = Flask(__name__).

2

Create POST endpoint /users

Add a route decorator @app.route('/users', methods=['POST']) and define a function called create_user that will handle POST requests.

Rest API

from flask import Flask, request

app = Flask(__name__)

# Your code here

Need a hint?

Use @app.route('/users', methods=['POST']) and define def create_user():.

3

Check JSON data and return 422 if missing 'name'

Inside create_user, get JSON data with request.get_json(). If the data does not have a 'name' key, return a JSON response with {'error': 'Missing name field'} and status code 422. Otherwise, return {'message': 'User created'} with status 200.

Rest API

from flask import Flask, request

app = Flask(__name__)

@app.route('/users', methods=['POST'])
def create_user():
    # Your code here

Need a hint?

Use data = request.get_json() and check if 'name' is missing. Return JSON with status 422 if missing.

4

Run the app and test output

Add code to run the Flask app with app.run(). Then, print the JSON response from a test POST request with missing name field to show the 422 error message.

Rest API

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/users', methods=['POST'])
def create_user():
    data = request.get_json()
    if not data or 'name' not in data:
        return jsonify({'error': 'Missing name field'}), 422
    return jsonify({'message': 'User created'}), 200

# Your code here

Need a hint?

Use app.test_client() to send a POST request with empty JSON and print status code and JSON response.