Дорогие коллеги и просто читатели. Часто встречаю путаницу в терминологии, когда речь идет об API и SDK. У многих нет понимания того, когда правильно писать/говорить API (application programming interface), а когда - SDK (software development kit). В этой статье хочу прояснить, в чем разница и когда какой термин нужно применять.
Чтобы сразу стало понятней, в чем суть путаницы, приведу несколько примеров:
- Мы говорим "Сесть за руль", но имеем ввиду сесть в автомобиль, частью которого является руль.
- Мы говорим "использовать метод из SDK", а по факту мы используем типы данных API, которое является частью SDK.
- Мы говорим "эта кнопка не работает", но одна не работающая кнопка - это неисправность внутри системы, которая взаимодействует с пользователем через кнопку, то есть за не работающей кнопкой скрывается не работающая линия связи или не работающий приемник сигнала от кнопки, хотя мы упорно твердим именно про кнопку.
- Мы говорим "в этом API сложно разобраться", по факту имея ввиду, что документация, которая входит в SDK кроме API, не достаточно подробна и понятна, а названия типов данных/методов в API такие, что интуитивно не разберешься, какое у них назначение. То есть мы говорим про SDK в целом, называя его API.
Зафиксируем первую основную мысль:
API - это часть SDK. Многие называют API, подразумевая под этим SDK и наоборот - говорят про SDK, хотя имеют ввиду API.
Теперь следующий пример. Мы говорим, мне нужно "отксерить" документы, имея ввиду сделать копию и не обязательно на копире фирмы Xerox, ведь фирм, производящих такие копиры много. Но такое название этого действия плотно укоренилось в нашей повседневной жизни.
Мы говорим, "использовать API", подразумевая веб-сервисы, хотя API бывает и офлайн, когда мы делаем дополнение к приложению, которое будет взаимодействовать по API не по сети, а локально.
Зафиксируем вторую основную мысль:
API - это не только про онлайн, веб, сайты. Есть ещё и другой формат работы API, без интернета.
И вот после этой второй мысли можно подвести итог, почему происходит путаница в терминологии:
- Не все в курсе, что некоторые API работают без интернета
- Не все в курсе, что API - часть SDK. Даже к API веб-сервисов/приложений есть документация и само API+документация могут полноправно называться SDK.
- Не все в курсе, что в SDK, кроме API и документации, могут входить дополнительные утилиты, помогающие разработчику сделать своё приложение.
Ну вы-то теперь в курсе и будете использовать эти термины верно )
О том, что такое API в клубе есть статья https://dzen.ru/a/Y5rWGRP6VHXdMqcQ
Всем спасибо за внимание!