Пишем простое API на Python с помощью Flask

Представьте, что вы хотите создать своё первое веб-приложение или сделать программный интерфейс (API), который может принимать запросы и возвращать ответы. Звучит сложно? На самом деле, с помощью Flask, простого, но мощного веб-фреймворка для Python, это очень легко сделать. Сегодня я покажу вам, как быстро написать простое API, которое сможет принять запросы и ответить на них.

Что такое Flask?

Flask — это лёгкий веб-фреймворк для Python, который позволяет легко создавать веб-приложения и API. Он прост в использовании и учёбе, а также идеально подходит для небольших проектов или для быстрого прототипирования идей. Flask — отличный выбор для тех, кто хочет быстро понять, как работает веб-разработка и как писать API.

Начинаем: Установка Flask

Прежде чем начать писать код, нам нужно установить Flask. Для этого откройте терминал и выполните следующую команду:

pip install Flask

После этого у вас будет установлен Flask, и можно приступать к написанию нашего первого API.

Создаём первый Flask API

Теперь создадим файл с названием app.py. В этом файле мы напишем код нашего API. Откройте редактор кода и вставьте следующий код:

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/')
def home():
    return "Добро пожаловать в наше простое API!"

@app.route('/api/greet', methods=['GET'])
def greet():
    response = {
        "message": "Привет! Это ответ от нашего API."
    }
    return jsonify(response)

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

Давайте разберёмся, что здесь происходит:

• Импортируем Flask и jsonify: Flask позволяет нам создавать веб-приложение, а jsonify используется для возврата данных в формате JSON.

• Создаём экземпляр Flask: app = Flask(__name__) — это создаёт наше приложение.

• Маршруты (@app.route()): Маршрут — это способ связать URL с функцией. Например, @app.route('/') связывает корневую страницу с функцией home, которая возвращает приветственное сообщение.

• Функция greet(): Она обрабатывает запрос по адресу /api/greet и возвращает JSON-ответ.

Запускаем API

Чтобы запустить наше API, вернитесь в терминал и выполните следующую команду:

python app.py

После этого Flask запустит сервер, и вы увидите сообщение вроде:

 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

Теперь вы можете открыть браузер и перейти по адресу http://127.0.0.1:5000/, чтобы увидеть сообщение "Добро пожаловать в наше простое API!". А если вы перейдёте по адресу http://127.0.0.1:5000/api/greet, то увидите JSON с приветствием.

Добавляем новые возможности

Создание API на Flask — это как игра в конструктор: вы можете добавлять новые маршруты и функции, чтобы API мог делать больше. Давайте добавим маршрут, который будет принимать имя пользователя и приветствовать его:

from flask import request

@app.route('/api/greet/<name>', methods=['GET'])
def greet_user(name):
    response = {
        "message": f"Привет, {name}! Это персональное приветствие от нашего API."
    }
    return jsonify(response)

Теперь, если вы откроете http://127.0.0.1:5000/api/greet/Вася, API вернёт вам персонализированное приветствие "Привет, Вася!"

Почему Flask — это просто и мощно

Flask хорош тем, что с его помощью можно быстро создавать прототипы и изучать веб-разработку, не тратя много времени на изучение сложных фреймворков. Он лёгкий, понятный и при этом достаточно мощный, чтобы справиться с большинством задач.

В отличие от других фреймворков, таких как Django, Flask не требует множества настроек и лишних файлов. Он даёт вам гибкость и контроль над проектом, что особенно важно, если вы только начинаете свой путь в программировании.

Заключение

Теперь вы знаете, как создать простое API на Python с помощью Flask. Это отличный способ начать свой путь в мире веб-разработки и понять, как работают серверы и клиентские запросы. Flask поможет вам легко и быстро создать свой первый проект, а дальше вы сможете усложнять его, добавлять новые функции и учиться на практике.