API - application programming interface, программный интерфейс приложения.
У приложений может быть два вида интерфейсов: пользовательский и программный. В пользовательском интерфейсе все кнопки и текстовые поля подписаны, чтобы пользователю было понятно, что нужно нажать и куда вводить текст. Каждая кнопка и текстовое поле - это способ взаимодействия программы с пользователем.
Программный интерфейс - это набор методов для взаимодействия одного приложения с другим. У API нет кнопок и полей, у него есть методы.
Пользовательский интерфейс - для взаимодействия пользователя (человека) с программой, API (программный интерфейс) - для взаимодействия программы с программой.
Например, у Youtube есть API. Я могу в своей программе отправлять такой web-запрос: GET https://www.googleapis.com/youtube/v3/videos?part=snippet%2CcontentDetails%2Cstatistics&id={VIDEO_ID}&key={YOUR_API_KEY}, подставив в него Id нужного мне видео и мой ключ API, который выдается каждому разработчику отдельно. Когда сервер Youtube получит такой запрос, он уже знает, что в ответ на него нужно прислать отправителю запроса всю информацию о видео: название, описание, время публикации, продолжительность и т. д. Сервер это знает, потому что разработчики Youtube API заранее прописали этот метод взаимодействия: формат запроса, алгоритм его обработки и формат ответа. Моя программа, получив ответ, обработает его так, как я ее научила.
Разработчики Youtube специально сделали такие методы взаимодействия с их приложением, чтобы другие программисты делали свои приложения на основе или с применением Youtube.
API могут быть платными и бесплатными, на усмотрение разработчиков. Есть API, в которых ограниченное количество бесплатных запросов и если нужно сделать больше запросов, то это уже за деньги.
Есть API к off-line приложениям. Например, у MS Office есть API. С его помощью можно создавать свои надстройки к программам, входящим в MS Office. API к off-line приложениям выглядит как библиотека с набором методов, с помощью которых можно научить свою программу взаимодействовать с той программой, API которой используется.
API у Web-приложений (простым языком у сайтов) называется Web-API, API у off-line приложений называется SDK (Software development kit).
Как программисты понимают, какие методы есть у API и как их использовать?
Для этого делают справочники API или руководства программиста, в которых описаны все существующие методы и способы их использования.
#api #описание #интерфейс