Build Your First REST API with Python and Flask: A Beginner's Guide

What Is a REST API and Why Should You Build One?

A REST API (Representational State Transfer Application Programming Interface) is the backbone of modern web applications. It allows different software systems to communicate over HTTP using standard methods like GET, POST, PUT, and DELETE. If you've ever used a weather app, logged into a website, or sent a payment — you've used a REST API.

In this tutorial, you'll build a simple but fully functional REST API using Python and the Flask micro-framework. No prior API experience is required, but basic Python knowledge is helpful.

Prerequisites

• Python 3.8 or higher installed
• pip (Python package manager)
• A code editor like VS Code
• Basic understanding of Python functions and dictionaries

Step 1: Set Up Your Environment

Start by creating a virtual environment to keep your project dependencies isolated:

mkdir flask-api && cd flask-api
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install flask

Step 2: Create Your First Flask App

Create a file called app.py and add the following code:

from flask import Flask, jsonify, request

app = Flask(__name__)

books = [
    {"id": 1, "title": "Clean Code", "author": "Robert C. Martin"},
    {"id": 2, "title": "The Pragmatic Programmer", "author": "Hunt & Thomas"},
]

@app.route('/books', methods=['GET'])
def get_books():
    return jsonify(books)

@app.route('/books/<int:book_id>', methods=['GET'])
def get_book(book_id):
    book = next((b for b in books if b['id'] == book_id), None)
    return jsonify(book) if book else ('Not found', 404)

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

Step 3: Run and Test Your API

Start the server with python app.py. Flask will launch on http://127.0.0.1:5000. You can test it using:

• Your browser (for GET requests)
• curl from the terminal: curl http://127.0.0.1:5000/books
• Postman — a free GUI tool for API testing

Step 4: Add POST Support

Let's allow clients to add new books via a POST request:

@app.route('/books', methods=['POST'])
def add_book():
    data = request.get_json()
    new_book = {"id": len(books) + 1, "title": data['title'], "author": data['author']}
    books.append(new_book)
    return jsonify(new_book), 201

Key Concepts to Remember

HTTP Method	Action	Example
GET	Read data	Fetch a list of users
POST	Create data	Add a new user
PUT	Update data	Edit a user's profile
DELETE	Remove data	Delete an account

Next Steps

You now have a working REST API! Here's how to take it further:

1. Connect a real database using SQLAlchemy
2. Add authentication with JWT tokens
3. Deploy your API to a cloud service like Render or Railway
4. Document your endpoints using Swagger/OpenAPI

Building REST APIs is one of the most marketable skills in software development. Master this foundation, and you'll be ready to power any web or mobile application.