Представьте ресторан. Вы (клиент) не идёте на кухню готовить сами — вы зовёте официанта и делаете заказ по меню. Официант относит заказ на кухню и приносит вам готовое блюдо.
Вы — программа-клиент (например, приложение погоды).
Меню — это и есть API: списокИзменяемая упорядоченная коллекция элементов: [1, 2, 3]. По-английски list. того, что можно попросить.
Официант — HTTP-запрос: несёт ваш заказ на сервер и возвращает ответ.
Кухня — сервер: готовит ответ, но как именно — вас не волнует.
Главная идея: вам не нужно знать, как устроена кухня. Достаточно знать меню (API) и уметь сделать заказ (запрос).
API простыми словами
API (Application Programming Interface) — это «меню» программы: список запросов, которые она понимает, и ответов, которые отдаёт. Когда приложение погоды показывает температуру — оно сходило в API метеослужбы и спросило данные.
В прошлом модуле через requests вы были клиентом — обращались к чужим API. Теперь станете сервером — напишете API, к которому смогут обращаться другие.
HTTP-методы
Веб-API работают по протоколу HTTP. Основные «глаголы»:
МетодФункция, привязанная к объекту и вызываемая через точку: text.upper().
Назначение
Пример
GET
получить данные
список товаров
POST
создать новое
добавить товар
PUT
обновить
изменить товар
DELETE
удалить
удалить товар
REST и эндпоинты
REST — это популярный стиль построения API: данные доступны по адресам (эндпоинтам) вида /users, /users/5, а действие задаётся HTTP-методом.
Коды ответа сообщают результат: 200 — ок, 201 — создано, 404 — не найдено, 500 — ошибка сервера.
📝Заметка
Почему FastAPI. Это современный фреймворк для API на Python: быстрый, с автоматической проверкой данных и готовой интерактивной документацией. Идеален для первого собственного сервиса.
💡Совет
🔮 Предскажите вывод
Коды ответа — это просто числа, которым сопоставлен смысл. Ниже обычная Python-функцияИменованный блок кода, который можно вызывать многократно. Может принимать аргументы и возвращать результат., которая по коду возвращает текст. Что выведут три вызова?
▶ predict-status.py
Разбор.200 и 404 есть в словареКоллекция пар «ключ → значение»: {"a": 1}. Быстрый доступ по ключу. По-английски dict., поэтому выведутся OK и Not Found. Кода 418 (шуточный «I'm a teapot») в нашем словаре нет, и .get() вернёт значение по умолчанию — Unknown. Точно так же реальный сервер: каждому числовому коду соответствует свой смысл.
⚠️ Частые ошибки новичков
Путают GET и POST. GET — только получить данные (ничего не меняет на сервере). POST — создать/отправить новые данные. Нельзя «создавать» через GET.
Думают, что код 200 значит «нет ошибок в данных». 200 — лишь «сервер успешно ответил». Логика приложения может вернуть 200 и при пустом результате.
Считают, что 404 — это поломка сервера. Нет: 404 — «такого адреса/ресурса нет». Поломка сервера — это 500.
❓Проверь себя
Какой HTTP-метод используют, чтобы получить данные?
Что означает код ответа 404?
Каким методом обычно создают новую запись на сервере?
ℹ️Важно
✅ Что вы узнали
API — «меню» программы, способ одной программе попросить данные у другой.
Веб-API работают по HTTP; основные методы — GET, POST, PUT, DELETE.
REST — стиль, где данные живут по адресам-эндпоинтам, а действие задаёт HTTP-метод.
Коды ответа (200, 201, 404, 500) сообщают результат запроса.
Комментарии
Загрузка…
Загрузка комментариев…