раздел 00

Что такое API

API (читается «эй-пи-ай», от Application Programming Interface) - это интерфейс, через который одна программа просит что-то у другой. Не кнопки и окна для человека, а заранее описанный способ для машин: «отправь вот такой запрос - получишь вот такой ответ».

Главное слово здесь - контракт. Сервис заранее договорился, что он умеет, как его об этом просить и что он вернёт. Вы соблюдаете контракт - получаете результат. Вам не нужно знать, как сервис устроен внутри.

Аналогия: официант в ресторане

Представьте ресторан. Вы (ваша программа) сидите в зале, кухня (чужой сервис) готовит еду. Напрямую на кухню вы не идёте - между вами есть официант. Это и есть API.

  • Вы говорите официанту заказ по меню - это запрос.
  • Меню - это документация: список того, что можно попросить.
  • Официант уносит заказ на кухню и приносит блюдо - это ответ.
  • Вам неважно, какая на кухне плита и кто повар. Важно, что заказ по меню приносит ожидаемое блюдо.

API - это меню и официант между вашей программой и чужим сервисом. Вы заказываете по меню и получаете результат, не заходя на кухню.

Зачем это нужно

Не нужно знать внутренности
Сервис сам решает свои задачи. Вам достаточно знать, как попросить и что придёт в ответ.
Чужая работа за вас
Курсы валют, карты, оплата, погода, отправка писем - всё это берут готовым через чужие API.
Программы собираются как кубики
Каждый сервис делает своё и общается с другими через API. Так строят почти все современные продукты.

Когда говорят «дёрни API сервиса», «отдай данные по API», «у них есть открытое API» - речь всегда об одном: есть согласованный способ попросить программу что-то сделать или отдать данные, и она это сделает.