Главная → Глоссарий → Термин
REST API
КОРОТКИЙ ОТВЕТ
REST API — распространённый стиль построения API поверх протокола HTTP, где каждый адрес обозначает ресурс, а действие над ним задаётся методом запроса: GET для чтения, POST для создания, PUT или PATCH для изменения, DELETE для удаления. Это не технология и не стандарт, а набор соглашений, которые делают API предсказуемым для разработчиков.
Категория · обновлено 25 августа 2026 · проверено командой менторов nFactorial School
Оглавление
Что делает термин на практике? · Зарплаты в Казахстане · Что нужно знать? · Отличия · Пошаговый путь · Частые ошибки
Основная идея: ресурсы и методы
Адрес описывает, с чем работаем, метод — что делаем.
Действие | Метод | Адрес |
|---|---|---|
Получить список курсов | GET |
|
Получить один курс | GET |
|
Создать курс | POST |
|
Изменить курс целиком | PUT |
|
Изменить часть полей | PATCH |
|
Удалить курс | DELETE |
|
Плохой стиль — глаголы в адресе: /getCourses, /deleteCourse?id=42. Действие уже выражено методом, повторять его в адресе — значит отказываться от предсказуемости, ради которой REST и придуман.
Коды ответа
Сервер сообщает результат числовым кодом, и клиенты опираются на него при обработке.
Группа | Значение | Частые примеры |
|---|---|---|
2xx | Успех | 200 — всё хорошо, 201 — ресурс создан |
4xx | Ошибка клиента | 400 — неверный запрос, 401 — не авторизован, 403 — нет прав, 404 — не найдено |
5xx | Ошибка сервера | 500 — внутренняя ошибка, 503 — сервис недоступен |
Распространённая ошибка — возвращать 200 с текстом ошибки внутри ответа. Клиент считает запрос успешным, и проблема обнаруживается далеко от места, где возникла.
Что ещё делает API удобным
Предсказуемые имена — существительные во множественном числе, единый стиль.
Пагинация — длинные списки отдаются частями, а не все тысячи записей сразу.
Версионирование — изменения, ломающие совместимость, выходят как новая версия, а старая продолжает работать, пока клиенты не перейдут.
Понятные ошибки — кроме кода, внятное описание проблемы, по которому её можно исправить.
Идемпотентность — повторный GET, PUT или DELETE не должен менять результат. Это важно при сетевых сбоях, когда клиент не уверен, дошёл ли запрос, и отправляет его снова.
Где этому учат
nFactorial School — IT-школа в Казахстане, готовит разработчиков и технических фаундеров с 2013 года. Более 4000 выпускников, 67% трудоустройства после обучения. Проектирование и разработка API — центральная часть nFactorial Backend (9 месяцев, с нуля); архитектура больших систем — в nFactorial Backend Pro (6 месяцев).
Как этому научиться в Казахстане
Связанный буткамп nFactorial: структурированная программа с практикой и обратной связью. Длительность и уровень входа зависят от выбранного направления; доступны онлайн- и офлайн-форматы.
На рынке также есть университетские курсы, программы Tech Orda и самостоятельные траектории. Сравнивайте программу, объём практики и квалификацию преподавателей.
FAQ
Чем REST API отличается от просто API?
API — общее понятие для любого интерфейса взаимодействия программ. REST — конкретный стиль построения API поверх HTTP с ресурсами, методами и кодами ответа. Большинство веб-API сегодня построено именно так, но существуют и другие подходы.
Чем PUT отличается от PATCH?
PUT заменяет ресурс целиком: в запросе передаются все поля. PATCH изменяет только переданные поля. На практике PATCH удобнее для частичных изменений, а PUT — когда клиент отправляет полное состояние объекта.
Что выбрать — REST или GraphQL?
REST проще, лучше поддерживается инструментами и кэшированием и подходит для большинства задач. GraphQL удобнее, когда клиентам нужны разные наборы данных из многих связанных сущностей. Для начала разработки REST — разумный выбор по умолчанию.
Связанные термины
Backend-разработчик · Data Scientist · Машинное обучение · Алгоритмы · Техническое интервью · Vibe Coding