Какво представлява API? Примери за използване на API

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

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

Тук ще обясним значението на API и как да ги използваме.

Какво е API?

Знаете ли как можете да виждате видеоклипове на стрийминг платформи като Netflix и YouTube, между другото? Възможно е, защото изпращате заявка чрез API.

Или сте си представяли как можете да плащате за стоките, които купувате от онлайн магазини като Amazon и eBay? Това е и защото има комуникационен канал, известен като API между вашата банка и приложенията за пазаруване.

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

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

API е като пратеник. Той се свързва със сървъра на доставчика от единия край и също така закотвя сървъра на клиента от другия край. След това той подава заявката на клиента към източника на данни (сървъра на доставчика) и връща отговор на клиента. Клиент тук е браузърът или вашето приложение.

Кука обаче прикачва приложението ви към API. Това е крайна точка на API. Много неща обаче се развиват зад кадър. Ще ги обясним допълнително.

Как API ви помагат да разработвате приложения по-бързо

API са по-интелигентен инструмент за изграждане на безпроблемни и стабилни приложения. Без тях изграждането на сложни приложения ще отнеме векове.

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

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

Този интерфейс (API) се свързва със сървъра, съдържащ техния код. След това ви подава обратно съответните данни от действието на техния скрипт.

Разбира се, не искате да се отегчавате с целия им изходен скрипт. Освен това повечето съвременни приложни програмни интерфейси (API) сега разчитат на стандартизирана технология REST (Представителен държавен трансфер). Това ги прави изключително мащабируеми и лесни за интегриране, без да се налага да се притеснявате за това какво се разгръща в рамките или състоянието на вашия отговор или заявка, тъй като те са предварително форматирани.

Тази статия няма повече да обяснява REST API. Засега се фокусирайте върху основите.

Включването на вашия код в техния е по-добра идея, отколкото да го пишете от нулата. За целта обаче трябва да свържете кода си с предоставения от тях API. Как се прави това? Ето къде на сцената излиза крайна точка на API.

Какво е крайна точка на API?

За да опростят нещата, доставчиците поставят URL, за да направят свързването с техния API безпроблемно. Такъв URL е Крайна точка на API. С него вашето приложение може след това да осъществи достъп до сървъра си чрез API и да комуникира директно със своя скрипт.

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

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

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

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

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

Правила за интегриране на API

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

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

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

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

За да се закръгли, извикването на API е всичко за хедъри, an крайна точка, заявка, и отговор или тяло.

Докато обяснихме какво е крайна точка, нека разделим допълнително тези други термини:

Хедъри

Обикновено трябва да опишете две форми на заглавки, докато се свързвате с API: заявка и отговор хедъри.

The заглавка на заявката е шлюзът на API извикване. Той описва подхода на клиента за достъп до ресурс. Той може да детайлизира неща като приемлив тип връзка, информация за прокси и тип данни (JSON, XML или HTML), които искате да получите от API.

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

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

API заявка

Заявката за API обикновено съдържа крайната точка в URL (Unique Resource Locator). Той използва протокола за прехвърляне на хипертекст (HTTP), за да намери адреса на ресурса, до който се опитвате да осъществите достъп чрез API. В крайна сметка заявката за API не е пълна, ако не включите крайната точка в URL адреса.

API отговор

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

След като получите отговор от API, можете да считате, че вашето API призоваване е успешно.

Как да използвам API: практически примери

Сега, след като знаете основите на API и какво е необходимо, за да го интегрирате. Погледнете как да свържете и интегрирате API за футболни прогнози от RapidAPI използвайки Python по-долу.

Това е просто API извикване, което връща JSON отговор. Можете също да напишете кода си в всеки текстов редактори го стартирайте чрез командния ред.

Свързани: Как да стартирате вашия Python Script

Обърнете обаче голямо внимание на крайната точка, съдържанието на заглавките на заявката и заглавията на отговорите:

заявки за внос
крайна точка = " https://football-prediction-api.p.rapidapi.com/api/v2/predictions"
queryparams = {"market": "classic", "iso_date": "2021-01-01", "federation": "UEFA"}
# Определете заглавката на заявката:
заглавки = {
'x-rapidapi-key': "Поставете вашия ключ за достъп тук",
'x-rapidapi-host': "football-prediction-api.p.rapidapi.com"
}
# Определете заглавката на отговора:
response = request.request ("GET", крайна точка, заглавки = заглавия, params = queryparams)
# Вземете отговора:
печат (response.text)

Продължавай да учиш: Как да използвам API на IPStack за търсене на геолокация IP

Какво ще кажете за получаване на текущата температура и влажност на дадено място API на Weatherstack с Python? Ето пример по-долу:

заявки за внос
крайна точка = ' http://api.weatherstack.com/current'
заглавки = {
"access_key": "Поставете своя ключ за достъп тук",
"заявка": "Калифорния"
}
req = request.get (крайна точка, заглавки)
res = req.json ()
print (u "Текущата температура в% s е% d ℃"% 
(res ["местоположение"] ["име"], res ["текущо"] ["температура"]))
печат (u "Текущата влажност в% s е% d ℃"% 
(res ["местоположение"] ["име"], res ["текущо"] ["влажност"]))

Видове API, които можете да интегрирате

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

Можете обаче да изберете и специален API, като сключите споразумение за партньорство с доставчик. Или можете да комбинирате няколко API за решаване на различни проблеми.

Също така тези API, с изключение на API с отворен код и вътрешни API, може да имат цена, понякога варираща от стотици до хиляди долари.

Опростете разработката на приложения с API

Както можете да видите, че вече не е необходимо да пишете отнемащ време код. Ако имате нужда от приложението си за извършване на сложни операции, винаги можете да търсите там и да вземете подходящ API. За щастие сега те са дори лесни за интегриране от старите конвенционални. И ако сте любопитни и искате да научите повече, има много безплатни API, които могат да ви помогнат да изцапате ръцете си.

Как работят API и как да ги интегрирате във вашето приложение

Използването на интерфейси за приложно програмиране (API) е основно умение за овладяване на всички програмисти.

Прочетете Напред

За автора