API — это официант между программами. Наконец-то нормальное объяснение
Без ресторанной магии: запрос, ответ, ключи и ошибки на одном понятном примере.
Одна программа редко умеет всё. Поэтому она зовёт другую и просит выполнить конкретную работу. Формальные правила такого разговора и называются API.
Запрос
Клиент отправляет адрес, метод, заголовки и иногда данные. Метод GET обычно просит информацию, POST — передаёт данные для обработки или создания чего-то нового.
Ответ
Сервер возвращает статус и тело ответа. 200 означает, что всё хорошо. 404 — ресурс не найден. 500 — сервер споткнулся о собственные шнурки.
Ключи
API-ключ похож на пропуск. Его нельзя вшивать в публичный JavaScript или выкладывать в GitHub. Храни ключ на сервере или в переменной окружения.