, функции, структури или константи), от които една компютърна програмаможе да взаимодейства с друга програма. Обикновено се включва в описанието на някои интернет протоколи (например RFC), софтуерна рамка (рамка) или стандарт за извикване на функции на операционната система. Често се изпълнява от отделна софтуерна библиотека или услуга на операционната система. Използва се от програмисти при писане на всякакви приложения.

API като средство за интеграция на приложения

API дефинира функционалността, която програмата (модул, библиотека) предоставя, докато API ви позволява да се абстрахирате от това как точно се изпълнява тази функционалност.

Ако една програма (модул, библиотека) се разглежда като черна кутия, тогава API е набор от „ръкохватки“, които са достъпни за потребителя на тази кутия и които той може да върти и дърпа.

Софтуерните компоненти взаимодействат помежду си чрез API. В този случай компонентите обикновено образуват йерархия - компонентите от високо ниво използват API на компоненти от ниско ниво, а те от своя страна използват API на компоненти от още по-ниско ниво.

На този принцип са изградени протоколите за пренос на данни през Интернет. Стандартен стекпротоколи (OSI мрежов модел) съдържа 7 нива (от физическо нивопредаване на битове надолу към протоколи за приложения като HTTP и IMAP). Всеки слой използва функционалността на предишния („по-нисък“) слой за пренос на данни и на свой ред предоставя необходимата функционалност на следващото („по-високо“) ниво.

Важно е да се отбележи, че концепцията за протокол е близка по смисъл до концепцията за API. И двете са абстракции на функционалността, само че в първия случай говорим за пренос на данни, а във втория говорим за взаимодействие на приложения.

API на библиотеката с функции и класове включва описание подписии семантика на функциите.

Функционален подпис

Понякога те разграничават подпис на повикванеи подпис за изпълнениефункции. Сигнатурата на повикване обикновено се компилира от синтактичната структура на извикване на функция, като се вземат предвид подписът на обхвата на дадената функция, името на функцията, последователността от действителни типове аргументи в извикването и типа на резултат. Сигнатурата на изпълнението обикновено включва някои елементи от синтактичната структура на декларацията на функцията: спецификатор на обхвата на функцията, нейното име и последователност от типове формални аргументи.

Например в езика за програмиране C++ проста функциясе разпознава уникално от компилатора по своето име и последователността от типове на неговите аргументи, което съставлява сигнатурата на функцията в този език. Ако функцията е метод от определен клас, тогава името на класа също ще бъде включено в подписа.

В индустрията софтуерОбщите стандартни API за стандартна функционалност са важни, защото гарантират, че всички програми, използващи общия API, ще работят еднакво добре или поне по типично познат начин. В случай на GUI API, това означава, че програмите ще имат подобни потребителски интерфейс, което улеснява процеса на усвояване на нови софтуерни продукти.

От друга страна, разликите в API на различни операционни системизначително усложняват прехвърлянето на приложения между платформи. има различни методизаобикалянето на тази сложност е писане на „междинни“ API (wxWidgets, GTK и др. GUI API), писане на библиотеки, които картографират системни извиквания на една ОС към системни извиквания на друга ОС (време за изпълнение като Wine, cygwin и т.н.), въвеждане на стандарти за кодиране в програмни езици (напр. стандартна библиотекаезик C), писане на интерпретирани езици, внедрени на различни платформи (python, perl, php, tcl, Java и др.).

Трябва също така да се отбележи, че програмистът често има няколко различни API на свое разположение, за да постигне един и същ резултат. Освен това всеки API обикновено се реализира с помощта на API софтуерни компонентипо-ниско ниво на абстракция.

Например: за да видите реда „Здравей, свят!“ в браузъра. ", просто трябва да създадете HTML документ с минимално заглавие и просто тяло, съдържащо тази линия. Когато браузърът отвори този документ, програмата на браузъра ще предаде името на файла (или вече отворен файлов дескриптор) на библиотеката, която обработва HTML документи, която от своя страна, използвайки API на операционната система, ще прочете този файл и ще разбере неговата структура , след това последователно извикване чрез API библиотека от стандартни графични примитиви като „изчистване на прозореца“, „напишете „Здравей, свят!“ с избрания шрифт“. Докато изпълнява тези операции, библиотеката с графични примитиви ще се свърже с библиотеката на интерфейса на прозореца със съответните заявки и тази библиотека ще извика API на операционната система, за да запише данни в буфера на видеокартата.

Освен това на почти всяко ниво всъщност има няколко възможни алтернативни API. Например: можем да напишем изходния документ не в HTML, а в LaTeX и можем да използваме всеки браузър за показване. Освен това различните браузъри използват различни HTML библиотеки и освен това всичко това може да се компилира с помощта на различни примитивни библиотеки и на различни операционни системи.

Следователно основните предизвикателства на съществуващите многостепенни API системи са:

Трудност при пренасянето програмен кодот една API система към друга (например при смяна на ОС);
Загуба на функционалност при преминаване от по-ниско ниво към по-високо. Грубо казано, всеки „слой“ на API е създаден, за да улесни изпълнението на някакъв стандартен набор от операции. Но в същото време става наистина трудно или става фундаментално невъзможно да се извършват някои други операции, които се предоставят от по-ниско ниво на API.

Най-известните API

Операционни системи

Този кратък срок е добре познат на всеки, който има поне малко опит с развитието. Но не всеки разбира какво точно означава и защо е необходимо. Разработчик Петър Газаровговори за API с прости думивъв вашия блог.

Съкращението API означава „Интерфейс за програмиране на приложения“ софтуерен интерфейсприложения). мнозинство големи компаниина определен етап API се разработват за клиенти или за вътрешна употреба. За да разберете как и как API се използват в разработката и бизнеса, първо трябва да разберете как работи World Wide Web.

World Wide Web и отдалечени сървъри

WWW може да се разглежда като огромна мрежа от взаимосвързани сървъри, на които се съхранява всяка страница. Един обикновен лаптоп може да се превърне в сървър, способен да обслужва цял уебсайт в мрежата, и локални сървъриразработчиците го използват за създаване на уебсайтове, преди да ги направят достъпни за обществеността.

При въвеждане в адресната лента на браузъра www.facebook.comСъответна заявка се изпраща до отдалечения Facebook сървър. След като браузърът получи отговора, той интерпретира кода и показва страницата.

Всеки път, когато потребител посети която и да е страница в мрежата, той взаимодейства с API отдалечен сървър. API е компонент на сървъра, който получава заявки и изпраща отговори.

API като начин за обслужване на клиенти

Много компании предлагат API като готов продукт. Например Weather Underground продава достъп до своя API за данни за времето.

Сценарий на използване:В сайта на малка фирма има форма за записване на час за клиенти. Компанията иска да интегрира Google Calendar в него, за да позволи на клиентите автоматично да създават събитие и да въвеждат подробности за предстояща среща.

API приложение:Целта е сървърът на сайта да се свърже директно със сървъра на Google с искане за създаване на събитие с посочените подробности, да получи отговора на Google, да го обработи и да изпрати подходящата информация до браузъра, например съобщение за потвърждение до потребителя .

Като алтернатива браузърът може да отправи заявка към API на сървъра на Google, без да минава през сървъра на компанията.

От API Календар на Googleразличен от API на всеки друг отдалечен сървър в мрежата?

Технически разликата е във формата на заявката и отговора. За да генерира пълна уеб страница, браузърът очаква отговор на езика HTML маркиране, докато API на Google Календар просто ще върне данни във формат като JSON.

Ако заявка към API е направена от сървъра на уебсайта на компанията, тогава той е клиентът (точно както браузърът е клиент, когато потребителят отвори уебсайта).

Благодарение на API, потребителят получава възможност да извърши действие, без да напуска уебсайта на компанията.

Повечето съвременни уебсайтове използват поне няколко API на трети страни. Много задачи вече имат готови решения, предлагани от разработчици на трети страни, било то библиотека или услуга. Често е по-лесно и по-надеждно да се прибегне до готово решение.

Много разработчици разпространяват приложението на няколко сървъра, които взаимодействат помежду си с помощта на API. Сървърите, които изпълняват поддържаща функция към основния сървър на приложения, се наричат микроуслуги.

Така че, когато една компания предлага API на своите потребители, това просто означава, че е създала серия от специални URL адреси, които връщат само данни като отговор.

Такива заявки често могат да се изпращат през браузър. Тъй като прехвърлянето на HTTP данни се извършва в текстова форма, браузърът винаги ще може да показва отговора. Например чрез браузър можете директно да получите достъп до GitHub API (https://api.github.com/users/petrgazarov), без токен за достъп, и да получите този отговор във формат JSON:

Браузърът перфектно показва JSON отговора, който може да бъде вмъкнат в кода. Достатъчно лесно е да извлечете данни от такъв текст, за да го използвате по свое усмотрение.

Още няколко примера за API

Думата "приложение" може да се използва в различни значения. В контекста на API това означава:

част от софтуера със специфична функция,
целия сървър, цялото приложение или само отделна част от приложението.

Всяка част от софтуера, която може да бъде ясно разграничена от околната среда, може да замени буквата „А“ в английска абревиатура и може също да има някакъв вид API. Например, когато разработчик внедри библиотека на трета страна в кода, той става част от цялото приложение. Като самостоятелна част от софтуера, библиотеката ще има някакъв вид API, който й позволява да взаимодейства с останалата част от кода на приложението.

В обектно-ориентирания дизайн кодът се представя като колекция от обекти. В едно приложение може да има стотици такива обекти, взаимодействащи един с друг. Всеки от тях има свой собствен API - набор публиченсвойства и методи за взаимодействие с други обекти в приложението. Обектите също могат да имат частен, вътрешна логика, която е скрита от околната среда и не е API.

Рано или късно всеки програмист се сблъсква с такава концепция като API. Въпреки това, когато се случи такава среща, не всеки знае какво е това, защо е необходимо и как да го използва. И в тази статия ще запълня тази празнина в знанията на някои от вас, както и ще дам пример от моята практика.

API (интерфейс за приложно програмиране) - Това интерфейс за приложно програмиране. По-точно на прост език, тогава това е набор от различни функции, константи, класове, формати на заявки, които могат да се използват в други програми.

Може да се счита, че API- това е определен обект, чиято реализация не знаем, но можем да го използваме. Например, компютърът е обект, чиято реализация много малко хора знаят, но почти всеки може да го използва за извършване на някои действия: гледане на видеоклипове, сърфиране в интернет, отпечатване на текст и др. Малко хора знаят как работи всичко, но почти всеки може да го направи.

Пример APIе API на Windows, OpenGL API, Direct3D APIи така нататък.

Например, неотдавна се сблъсках и директно API. Регистрирах се за услугата пощенски списък" SmartResponder.ru" и стартира бюлетин, за който хората започнаха да се абонират. Задачата беше следната: в рамките на 24 часа след абонирането човек може да закупи моя платен видео курс с отстъпка. Тъй като цялата информация за абонатите се съхранява на сървъра " SmartResponder.ru", след това нормален достъп (например чрез DB) Нямах достъп до тези данни, но беше необходимо да ги внедря. За щастие, " SmartResponder.ru„имай си собствен API, който използвах.

Намерих в тях APIформат на заявка, за да получите датата на абонамент като резултат. По-нататък cURLИзпратих съответната заявка и получих необходимата дата за абонамент за конкретен имейл адреси . Следва стандартна обработка и извеждане на резултата.

API дефинира функционалността, която дадена програма (модул, библиотека) предоставя, докато API ви позволява да се абстрахирате от това как точно се изпълнява тази функционалност.

Ако една програма (модул, библиотека) се разглежда като черна кутия, тогава API е набор от „копчета“, които са достъпни за потребителя на тази кутия, които той може да върти и дърпа.

На този принцип са изградени протоколите за пренос на данни. Стандартният интернет протокол (OSI мрежов модел) съдържа 7 слоя (от физическия слой на предаване на битови пакети до слоя на приложни протоколи като HTTP и IMAP протоколи). Всеки слой използва функционалността на предишния слой за пренос на данни и от своя страна предоставя необходимата функционалност на следващия слой.

Важно е да се отбележи, че концепцията за протокол е близка по смисъл до концепцията за API. И двете са абстракции на функционалността, само че в първия случай говорим за пренос на данни, а във втория говорим за изграждане на компютърни приложения.

API на библиотеката с функции и класове включва описание подписии семантика на функциите.

Application Programming Interface (API) е софтуерен интерфейс за взаимодействие между системите, позволяващ:

Получете достъп до корпоративни бизнес услуги
Обмен на информация между системи и приложения
Опростете взаимодействията между компании, партньори, разработчици и клиенти

Open API стратегия

API стратегията включва:

Разработване на бизнес продукти, базирани на съществуващи API
Предоставяне на вътрешни услуги на разработчиците
API модели за монетизация за изграждане на многоканално взаимодействие и увеличаване на печалбите

Внедряването на концепцията Open API спомага за трансформирането на бизнеса, интегрирането му в гъвкава проектна екосистема от пазарни играчи, създава условия за постоянно генериране на нови идеи и създаване на допълнителна стойност при управление на масиви от корпоративни данни.

Пазарът на интеграционни решения се развива в контекста на еволюцията на API – от EDI и SOAP до Web 2.0, с което започна ерата на публичните API. Броят на такива интерфейси през следващите 3 години може да нарасне над 50 пъти и да достигне 1 милион. Това се дължи на omnichannel: каналите за взаимодействие с клиентите трябва да се променят заедно с тях. Непрекъснатият растеж на броя на потребителите и обема на данните доведе до появата на API икономика, която помага отворени интерфейсисъздаване на иновативни бизнес модели за използване на корпоративни активи и услуги.

Функционален подпис

Функционален подпис- Част общо съобщениефункции, които позволяват на инструментите за превод да идентифицират функция сред другите. Различните езици за програмиране имат различни идеи за сигнатурата на дадена функция, което също е тясно свързано с функционалността на претоварването на функциите в тези езици.

Понякога те разграничават подпис на повикванеи подпис за изпълнениефункции. Сигнатурата на повикване обикновено се компилира от синтактичната структура на извикване на функция, като се вземат предвид подписът на обхвата на дадената функция, името на функцията, последователността от действителни типове аргументи в извикването и типа на резултат. Сигнатурата на изпълнението обикновено включва някои елементи от синтактичната структура на декларацията на функцията: спецификатор на обхвата на функцията, нейното име и последователност от типове формални аргументи.

Например в езика за програмиране C++ една проста функция се идентифицира уникално от компилатора чрез нейното име и последователността от типове на нейните аргументи, което съставлява сигнатурата на функцията в този език. Ако функцията е метод от определен клас, тогава името на класа също ще бъде включено в подписа.

Трябва също така да се отбележи, че програмистът често има няколко различни API на свое разположение, за да постигне един и същ резултат. Освен това всеки API обикновено се реализира с помощта на софтуерни компоненти на API с по-ниско ниво на абстракция.

Например: за да видите реда „Здравей, свят!“ в браузъра. Просто трябва да създадете HTML документ с минимално заглавие и просто тяло, съдържащо този ред. Какво се случва, когато браузърът отвори този документ? Програмата на браузъра ще предаде името на файла (или вече отворен файлов дескриптор) на библиотеката, която обработва HTML документи, която от своя страна, използвайки API на операционната система, ще прочете този файл и ще разбере неговата структура, извиквайки операции като „изчистване на прозорец”, „напишете Здравей, свят с избрания шрифт!”, по време на тези операции библиотеката от графични примитиви ще се свърже с библиотеката на интерфейса на прозореца със съответните заявки, а тази библиотека ще се свърже с API на операционната система със заявки като „поставете го в видеокартата ми буферира това."

Освен това на почти всяко ниво всъщност има няколко възможни алтернативни API. Например: можем да напишем изходния документ не в HTML, а в LaTeX и можем да използваме всеки браузър за показване. Различни браузъри, най-общо казано, използват различни HTML библиотеки и освен това цялото нещо може (най-общо казано) да бъде компилирано с помощта на различни примитивни библиотеки и на различни операционни системи.

Следователно основните предизвикателства на съществуващите многостепенни API системи са:

Трудност при пренасяне на програмен код от една API система към друга (например при смяна на ОС);
Загуба на функционалност при преминаване от по-ниско ниво към по-високо. Грубо казано, всеки „слой“ на API е създаден, за да улесни изпълнението на някакъв стандартен набор от операции. Но в същото време става наистина трудно или става фундаментално невъзможно да се извършват някои други операции, които се предоставят от по-ниско ниво на API.