— Здравствуйте, коллеги. Садитесь поудобнее. Сегодня мы поговорим о том, что нельзя потрогать, но без чего не работает ни одно современное приложение. О API.

Глава 1. API — это не магия, это договорённость Посмотрите внимательно.

Есть клиент — условное приложение, сайт или мобильный телефон. А есть сервер — место, где хранятся данные, логика, всё самое ценное. Между ними всегда есть договорённость. API — это и есть эта договоренность. Чёткое правило: «Если ты отправишь мне данные вот в таком формате — я отвечу предсказуемо. Если нет — я скажу, что пошло не так». Задача тестировщика — проверить, выполняет ли сервер свои обещания и умеет ли клиент правильно разговаривать.

Глава 2. HTTP-методы. Пять основных действий

Выучите их как свои пять пальцев. Без них вы не сможете провести ни один тест.

GET — получить. Вы спрашиваете у системы: «Покажи мне пользователя с номером пять». Система показывает. Ничего не меняется. Это безопасный запрос. POST — создать. Вы говорите: «Создай нового пользователя». Сервер создаёт, назначает ему уникальный идентификатор и возвращает его вам. PUT — полностью заменить. Вы решили, что старые данные больше не нужны. Вы отправляете новый объект целиком, и сервер заменяет им старый. PATCH — частично изменить. Исправляете только одно поле. Например, только телефон пользователя. Всё остальное остаётся без изменений. DELETE — удалить. Убираете сущность из системы. Ответственно, безвозвратно.

Глава 3. Статус-коды. Язык, на котором говорит сервер

Сервер никогда не молчит. Он всегда даёт ответ с цифровым кодом. Ваша задача — выучить основные группы, чтобы читать этот язык как родной. 2xx — всё хорошо, можно расслабиться. · 200 — успешный ответ. Данные получены. · 201 — объект создан. Поздравляю, вы родитель новой записи в базе. · 204 — всё выполнено, но сервер не возвращает тело ответа. Просто принимает к сведению. 4xx — проблема на стороне клиента. Отправитель запроса что‑то сделал не так. · 400 — сервер не может обработать запрос из-за ошибки в данных. Например, отправили буквы вместо цифр. · 401 — требуется авторизация. Клиент не представился. · 403 — доступ запрещён. Клиент представился, но прав у него недостаточно. · 404 — ресурс не найден. Такого адреса или объекта не существует. · 429 — слишком много запросов. Клиент превысил допустимую частоту. 5xx — проблемы на стороне сервера. Вы не виноваты, но разбираться придётся вам. · 500 — внутренняя ошибка сервера. Что‑то пошло не так в коде. · 502 — шлюз выдал неверный ответ. Промежуточный узел сломался. · 503 — сервер временно недоступен. Например, перегружен или на обслуживании.

#тестирование #тестированиеapi #api #лиля_тестирует #простымисловами #искусствотестирования