API
программный интерфейс
Это понятие впервые встречается на программе «Разработка и инженерия для старшеклассников» — примерно 15-17 лет (9-11 класс).
Способ, которым одна программа просит услугу у другой по строгим правилам: посылает запрос — получает готовый ответ, не зная, как всё устроено внутри.
Окошко выдачи в кафе: называешь по меню номер блюда — получаешь заказ, заходить на кухню не нужно.
Объяснить, как погодное приложение узнаёт погоду: оно не считает её само, а запрашивает у чужого сервиса погоды по его правилам.
Программный интерфейс — набор правил, по которым одна программа обращается к другой: какие запросы можно послать, с какими данными и что вернётся в ответ. Поставщик прячет внутреннюю кухню и отдаёт только оговорённый результат. В интернете API часто работает поверх HTTP: приложение шлёт запрос на адрес сервиса и получает структурированный ответ.
По документации открытого API (например, сервиса погоды) собрать в адресной строке браузера запрос с нужным городом и рассмотреть, что вернулось в ответе.
Контракт между программами: конечные точки (endpoints), формат запросов и ответов, правила аутентификации и ошибок. Распространён REST поверх HTTP: методы GET/POST/PUT/DELETE, ресурс задаётся URL, данные — в JSON, результат — по коду состояния (200 — успех, 401 — не авторизован, 404 — нет ресурса). Доступ ограничивают ключом (API-key) и лимитом запросов (например, N в минуту). Краевой случай: меняя API, поставщик выпускает новую версию (v1, v2), чтобы старые клиенты не сломались.
Отправить запрос к открытому REST API (в браузере или через fetch), прочитать код состояния и разобрать одно поле из JSON-ответа; повторить запрос без ключа или сверх лимита и объяснить полученную ошибку.
Частое заблуждение
«API — это готовая программа или сайт». Нет: API — не программа, а описание, как к программе обращаться: какие запросы слать и что придёт в ответ. Пользуются им другие программы, а не человек глазами.