Как создать REST API с помощью FastAPI

🚀 Как создать REST API с помощью FastAPI: от нуля до героя Swagger 🚀

Давайте будем честны: раньше создание API было примерно таким же увлекательным занятием, как отладка CSS. (Вы знаете, это правда.) Но потом появился FastAPI, и внезапно создание REST API стало похоже не столько на борьбу с медведем, сколько на сборку LEGO — если бы эти кубики LEGO поставлялись с автоматической документацией и подсказками по типам.

Итак, любопытный программист, готов ли ты раскрыть своего внутреннего архитектора API? Давайте смешаем немного остроумия с мудростью и разберёмся, как создать свой первый REST API с помощью FastAPI. Спойлер: у вас будет работающий API ещё до того, как остынет кофе.

1. FastAPI: краткий пересказ

Думайте о FastAPI как о ответе Python на вопрос «Мне нужно быстро и просто». Он создан на основе Starlette и Pydantic, что означает встроенную поддержку асинхронности и проверку данных — никаких дополнительных настроек не требуется.

2. Установите его перед приготовлением на гриле

Для начала давайте установим самое необходимое:

pip install fastapi uvicorn

увикорн — это сервер ASGI, который заставляет FastAPI работать на ура.

3. Привет, мир! (Или: API-эквивалент)

Вот минимальный API, который приветствует вас. (Удивите своих друзей. Или хотя бы своего линтера.)

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def read_root():
    return {"message": "Hello, API World!"}

Запустите его с помощью:

uvicorn main:app --reload

(–reload позволяет перезагрузить серверы в режиме реального времени. Ведь кому захочется останавливать и запускать серверы, как будто на дворе 2007 год?)

4. Достижение конечных целей: CRUD без CRUD

Давайте немного пофантазируем и построим Дела API. Ведь, давайте посмотрим правде в глаза, кто не любит списки?

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class Todo(BaseModel):
    task: str
    done: bool = False

todos = []

@app.post("/todos")
def create_todo(todo: Todo):
    todos.append(todo)
    return {"message": "To-Do added!", "todo": todo}

@app.get("/todos")
def read_todos():
    return todos

Теперь вы можете:
– Создайте задачу с помощью POST-запроса.
– Получите все задачи с помощью GET-запроса.

И вуаля — ваш API только что поднялся с уровня «Hello World» до уровня «Я действительно полезен».

5. Автоматические документы: потому что читать мысли сложно

Откройте в браузере http://localhost:8000/docs И приготовьтесь к ошеломляющим впечатлениям: FastAPI автоматически генерирует интерактивную документацию Swagger. Больше не нужно писать документацию, которую никто не прочитает (кроме, возможно, вас через полгода).

6. Почему FastAPI так хорош (помимо названия)

• Скорость: Поддержка асинхронности из коробки. Ваш API может обработать больше запросов, чем мем про кота на Reddit.
• Тип безопасности: Если вы любите автодополнение и ненавидите ошибки времени выполнения, то подсказки типов FastAPI — это то, что вам нужно.
• Документация: Ваши конечные точки документируют сами себя, словно волшебные эльфы.

Окончательное размышление

С FastAPI создание REST API превращается не в мучения, а в удовольствие, которое вы получаете, потягивая кофе, пока ваши конечные точки работают без сбоев. Кто бы мог подумать, что Python может быть таким… быстрым?

А теперь вперёд, воплощайте свои идеи в API. Только не забудьте проверить свой список дел — в конце концов, вы его создали!

Будьте любознательны, продолжайте программировать, и пусть ваши серверы всегда будут такими же быстрыми, как ваши амбиции. 🚀

—Пичаи (ну, почти)