How to Quickly Build APIs in Python

APIs are the backbone of most applications that rely on data exchange or external integrations.

Learning to build APIs in Python can open up many opportunities to connect your app with other systems and make a versatile backend.

Here, I’ll walk you through the basics of APIs, creating REST APIs, and building them with Flask and FastAPI—two popular Python frameworks.

1. Introduction to APIs

In today’s digital world, APIs are everywhere.

They allow different systems and applications to talk to each other, sharing data and functionalities seamlessly.

For example, when you use an app to check the weather, it's actually calling an API that returns the weather data.

APIs make life easier by acting as intermediaries that process requests and return data in a standardized way.

It’s also worth noting that APIs don’t only serve client applications (like websites or mobile apps).

APIs can be used between backend systems or microservices within the same infrastructure to manage data more efficiently.

2. REST APIs

REST (Representational State Transfer) is one of the most popular ways to create APIs due to its simplicity and compatibility with HTTP.

RESTful APIs are structured to allow standard HTTP methods (like GET, POST, PUT, DELETE) to manipulate resources.

They’re often used to manage CRUD (Create, Read, Update, and Delete) operations, where each request method performs an operation on the resource data.

If you're building a web service, REST is likely the most approachable and widely supported format to start with.

REST APIs are also stateless, which means each request operates independently, allowing REST APIs to scale more easily.

3. Building an API with Flask

Flask is my go-to for small or medium-sized projects, as it’s lightweight and easy to get up and running.

Flask lets you control nearly every aspect of your API, but it also requires a bit more work on data validation and error handling.

This flexibility, though, is ideal for those who want more control over how each part of the API functions.

Example of Creating a Flask API

Here’s how a task management API can look in Flask.

First, make sure to install flask with pip:

pip install flask

This example shows how you can quickly set up endpoints for getting and creating tasks, as well as updating and deleting.

from flask import Flask, jsonify, request

app = Flask(__name__)

tasks = [
    {"id": 1, "task": "Learn Flask", "done": False},
    {"id": 2, "task": "Build API", "done": False}
]


@app.route('/tasks', methods=['GET'])
def get_tasks():
    return jsonify({"tasks": tasks})


@app.route('/tasks', methods=['POST'])
def create_task():
    new_task = {
        "id": len(tasks) + 1,
        "task": request.json["task"],
        "done": False
    }
    tasks.append(new_task)
    return jsonify(new_task), 201


@app.route('/tasks/<int:task_id>', methods=['GET'])
def get_task(task_id):
    task = next((task for task in tasks if task["id"] == task_id), None)
    if task:
        return jsonify(task)
    return jsonify({"message": "Task not found"}), 404


@app.route('/tasks/<int:task_id>', methods=['PUT'])
def update_task(task_id):
    task = next((task for task in tasks if task["id"] == task_id), None)
    if task:
        task.update(request.json)
        return jsonify(task)
    return jsonify({"message": "Task not found"}), 404


@app.route('/tasks/<int:task_id>', methods=['DELETE'])
def delete_task(task_id):
    task = next((task for task in tasks if task["id"] == task_id), None)
    if task:
        tasks.remove(task)
        return jsonify({"message": "Task deleted"})
    return jsonify({"message": "Task not found"}), 404


if __name__ == '__main__':
    app.run(debug=True)

This Python code sets up a REST API using Flask to manage a list of tasks, allowing clients to create, retrieve, update, and delete tasks.

The tasks are stored in a list where each task is a dictionary with an id, task, and done status.

The /tasks endpoint supports GET requests to return the full list of tasks and POST requests to add new tasks, automatically assigning each task a unique ID.

Additional endpoints, /tasks/<int:task_id>, allow users to interact with individual tasks: GET retrieves a specific task by ID, PUT updates it, and DELETE removes it from the list.

If a task with the specified ID is not found, these endpoints return a 404 error with an appropriate message.

The API runs in debug mode, making it ideal for development and testing purposes.

Just be aware that for larger projects, you might need to add more structured routing and validation mechanisms.

4. Building an API with FastAPI

FastAPI is an excellent choice for performance-sensitive applications or projects that require a bit more structure and type safety.

FastAPI is designed to be faster by default (thanks to its asynchronous capabilities) and offers robust data validation out-of-the-box using Pydantic.

I’ve found FastAPI very intuitive and easy to work with, especially for projects where I need async capabilities and want built-in validation without third-party packages.

Plus, the automatic documentation (via Swagger UI) makes it extremely convenient.

Example of Creating a FastAPI API

Here’s how the task management API could look in FastAPI.

Don't forget to first install fastapi and uvicorn with pip:

pip install fastapi uvicorn

Then you can create the API: