☕️ Про API

Пост для тех, кто слышит слова "API", "эндпоинт", "REST", но до конца не понимает, как это работает и зачем нужно.

Это как меню в ресторане: вы выбираете блюдо (request/запрос), официант (API) передаёт заказ на кухню (сервер) и приносит результат (response). Вам не нужно знать, как готовят — достаточно указать, что хотите.

Выше, в карточках, можно узнать подробнее как это устроено, а ниже основные термины:

🧩 Resource (ресурс) — объект, с которым работает API (например, пользователь, заказ). Каждый ресурс имеет свой URL (адрес), например, /users/123.

🚪 Endpoint (Эндпоинт) — адрес, по которому можно обратиться к API. Как почтовый ящик, но для данных. Например: api.example.com/users — это endpoint для получения списка пользователей.

📬 HTTP Methods (Методы запросов) — глаголы, которые говорят API, что вы хотите сделать: GET — запросить данные (как прочитать письмо); POST — отправить новые данные (как отправить письмо); PUT/PATCH — изменить существующие данные; DELETE — удалить данные.

📤 Request (Запрос) — сообщение от клиента к серверу с просьбой что-то сделать. Как письмо с надписью «Хочу список пользователей».
Состоит из: метода (GET), эндпоинта (/users), заголовков и тела (если нужно).

📥 Response (Ответ) — сообщение от сервера в ответ на запрос. Как конверт, который пришёл обратно: «Вот список пользователей» или «Ошибка: доступ запрещён».
Содержит: статус-код (200, 404), заголовки и тело с данными.

📄 Body (Тело) / Payload (Полезная нагрузка) — основное содержимое запроса или ответа. Как текст письма внутри конверта.

📝 Headers (Заголовки) — служебная информация о запросе/ответе — как надписи на конверте: «Срочно», «Только для вас».
Примеры: Content-Type: application/json (тип данных), Authorization: Bearer token (ключ доступа).

🔑 API Key (Ключ API) — уникальный идентификатор, как пароль для доступа к API. Нужен, чтобы система знала, кто делает запрос.
Представьте это как пропуск на работу — без него вас не пустят.

🚦 Status Codes (Коды ответов) — Числа, объясняющие результат запроса: 200 OK — всё хорошо, 404 Not Found — не найдено, 401 Unauthorized — нет доступа.
Как светофор: зелёный — едем, красный — стоп.

👀 Смотрите также
1. RESTful APIs in 100 Seconds
2. APIs Explained in 6 Minutes

#api #ликбез #simplewords