FastAPI tutorial: первый API с проверкой входных данных
Первый API удобно сделать для оценки длительности задач. Клиент отправляет название и число минут, сервер проверяет данные и возвращает нормализованную запись. Пока без базы: так проще увидеть, что именно делает обработчик.
Создайте окружение и приложение
В отдельной папке создайте виртуальное окружение Python и активируйте его. Затем установите пакет командой python -m pip install 'fastapi[standard]'. Сохраните следующий код в main.py:
from fastapi import FastAPI
from pydantic import BaseModel, Field
app = FastAPI()
class Estimate(BaseModel):
title: str = Field(min_length=1, max_length=120)
minutes: int = Field(gt=0, le=480)
@app.post("/estimates/", status_code=201)
def create_estimate(value: Estimate):
return value
Запустите fastapi dev main.py. Режим разработки не предназначен для публичного рабочего сервиса. Основы установки и обработки запросов описаны в руководстве FastAPI.
Проверьте запросы через документацию
Откройте /docs на адресе запущенного сервера. Передайте название и minutes: 30, затем попробуйте ноль и строку вместо числа. Посмотрите, чем отличаются успешный ответ и ошибка валидации.
Обратите внимание: ограничение длины строки не отклоняет название из одних пробелов. Если это запрещено вашим правилом, нужна нормализация или дополнительная проверка.
Что добавить перед реальным использованием
Пример не сохраняет записи. После успешного ответа задача нигде не появится, пока вы не подключите хранилище. Следующий шаг — таблица, миграция, проверка прав и тесты обработчика. Не добавляйте async механически: выбор зависит от того, какие операции ввода-вывода выполняются внутри.
Контракт более полного сервиса разобран в статье как создать REST API, а выбор между подходами — в Django vs FastAPI.