Co to jest API?
Opublikowany: 2020-07-27
Jeśli od dłuższego czasu pracujesz z technologią, prawdopodobnie spotkałeś się z terminem API. Dla tych, którzy programują i rozumieją, jak zrobić stronę internetową od podstaw, termin API będzie Ci dobrze znany.
Interfejs API kryje się za wieloma popularnymi funkcjami, z których korzystasz na stronach internetowych. Jest to akronim oznaczający interfejs programowania aplikacji. Dobrą ilustracją byłoby wymyślenie przepisu na różne rodzaje jedzenia. Każdy przepis zawiera instrukcje krok po kroku, jak przygotować danie. To jest kod związany z API. Aby wykonać zadanie, komputer musi postępować zgodnie z zestawem instrukcji.
Możesz wziąć ten przepis i dać go dowolnemu kucharzowi. Będą mogli zinterpretować składniki i dowiedzieć się, jak połączyć wszystkie różne elementy w gotowy produkt. Masz nawet możliwość samodzielnego podążania za wskazówkami, aby ułożyć przepis, jeśli rozumiesz gotowanie i masz wystarczające szkolenie, aby korzystać ze wszystkich narzędzi w kuchni. Ostatecznie API to tylko przepis, który komputer rozumie, jak postępować.
Deweloperzy i API
Kontynuując naszą ilustrację działania interfejsu API, niektórzy przyniosą przepis profesjonalnemu kucharzowi, który może szybko przygotować jedzenie i podać dowolne danie, które zamówisz. Deweloper jest jak osoba, która już może stworzyć przepis i go zmodyfikować.
API to seria instrukcji do komputera. Programiści z doświadczeniem w kodowaniu mogą modyfikować niektóre aspekty interfejsu API i modyfikować je, aby spełniały swoje potrzeby. Będzie to poza zasięgiem wielu osób, które chcą po prostu podłączyć interfejs API do swojej witryny.
Korzystanie z interfejsu API jest dobre dla zwykłych użytkowników, ponieważ pozwala im uzyskać więcej funkcji ze swojej witryny bez samodzielnego tworzenia kodu. Może chciałbyś wyświetlić pogodę i czas dla użytkownika odwiedzającego Twoją stronę. Ta treść jest dynamiczna, a nie statyczna. Nie możesz po prostu odłożyć pogody na jeden dzień i ją zostawić. Wartość ciągle się zmienia, więc musisz uzyskać dostęp do interfejsu API, aby informacje były aktualizowane.
API i WordPress
Jeśli korzystasz z WordPressa i szukasz sposobu na integrację API, zalecamy zrobienie tego za pomocą wtyczki lub motywu WordPress. Wiele darmowych i premium wtyczek może pomóc w dość łatwej integracji interfejsów API. Jednak większość z nich jest bardzo ograniczona, chyba że zapłacisz.
Jeśli sam posiadasz wiedzę na temat kodowania, możesz łatwo zintegrować zewnętrzny interfejs API w swojej witrynie WordPress. W tym celu zalecamy ten przewodnik Rapidapi, który wyjaśnia, jak zintegrować zewnętrzne interfejsy API.
Treść dynamiczna
Zawsze, gdy masz do czynienia z treściami dynamicznymi, pierwszą myślą powinno być znalezienie interfejsu API, który może przesyłać szybko zmieniające się informacje do Twojej witryny. Może również pozwolić na głębszą interakcję z popularnymi programami.
Weźmy na przykład Twittera. To popularna platforma dla osób zainteresowanych mediami społecznościowymi. Jeśli jesteś częścią marketingu cyfrowego, będziesz chciał uzyskać dostęp do rzeczy na głębszym poziomie. Korzystając z interfejsu API Twittera, możesz szybko przeciągnąć informacje do arkuszy kalkulacyjnych, aby je rozbić i określić, na przykład, jakie są zainteresowania użytkowników i ile mają połączeń. Jeśli jesteś marketerem cyfrowym, będziesz chciał szybko identyfikować osoby w określonych grupach demograficznych, aby wiedzieć, jakie produkty im zaoferować. Interfejs API Twittera umożliwia robienie tych rzeczy, ponieważ możesz pobierać ogromne ilości informacji za jednym razem, zamiast kompilować wszystko ręcznie.
Ulepszanie Twojej witryny
Pokrótce przyjrzeliśmy się, jak możesz ulepszyć swój biznes, korzystając z interfejsu API dla dużej firmy. Co jeszcze możemy wyciągnąć z zewnętrznych stron internetowych? Oprócz wczytywania pogody dla użytkownika, która dynamicznie się zmienia, możemy wyświetlić coś ciekawszego.
Jak chcesz stronę internetową, która może wyświetlać najnowsze obrazy z Flickr, a nawet Facebooka? To byłaby świetna zawartość dla twoich użytkowników, którą będą zainteresowani. W tym celu najpierw znajdź dokumentację API dla Flickr. Ważne jest, aby najpierw przejść przez to, jeśli napotkasz problemy z integracją interfejsu API ze swoją witryną.
Teraz zobaczysz możliwość zażądania żądanego formatu. W przypadku wielu interfejsów API będziesz mieć do wyboru REST, XML-RPC i SOAP. W takim przypadku wybierz REST, który jest bardzo popularny w witrynach WordPress. Po kliknięciu na to zostanie wyświetlony punkt końcowy interfejsu API Flickr REST.
Co to jest ODPOCZYNEK?
REST to kolejny akronim, którego należy się nauczyć, jeśli chcesz mieć dynamiczną i stale zmieniającą się zawartość w swojej witrynie. Dzięki REST możemy następnie użyć GET, POST i DELETE. Dotyczy to dowolnych danych na Flickr, ale działa również na Facebooku, Google lub Instagramie.
Akronim oznacza Reprezentacyjne Przekazanie Stanu. Został stworzony w celu dystrybucji hipermediów i po raz pierwszy trafił na scenę z Royem Fieldingiem w 2000 roku. Możesz teraz mieć żądania HTTP, które będą pobierać dane dla Ciebie. Żądania HTTP mogą również wysyłać dane do innych stron internetowych. API to język, którym posługują się dwa programy komputerowe, rozmawiając ze sobą i komunikując się. Rozumiejąc ten język i sposób jego działania, możesz pobierać dane z niemal każdej witryny.

Klucze API
Witryny internetowe nie ułatwią pobierania danych do wyświetlenia w witrynie WordPress. Najpierw musisz założyć konto. Gdy masz już konto w witrynie, poproś ich o klucz API. Upewnij się, że przeczytałeś warunki korzystania z usługi. Istnieją określone terminy, które będą się różnić w zależności od tego, z jaką witryną internetową pracujesz. Niektóre witryny ograniczają liczbę żądań HTTP GET, które można wykonać w określonym przedziale czasu.
Być może jesteś ograniczony do zaledwie 50 żądań GET na dany dzień. Daje to pewność, że serwery nie są stale atakowane przez ludzi, którzy chcą wysyłać żądania dotyczące zasobów. Możesz wielokrotnie zwiększać limity, wybierając wersję Pro lub wersję komercyjną. Po uaktualnieniu będziesz mieć dostęp do większej liczby żądań HTTP, których używasz do wywoływania serwerów. Jest to zwykle używane przez firmę, która musi wykonać wiele połączeń i nie dotyczy zwykłego użytkownika, który tylko próbuje wyświetlić nowe informacje w swojej witrynie.
Złóż wniosek o pozwolenie
Nie zawsze będziesz mógł uzyskać pozwolenie na posiadanie klucza API. Niektóre witryny wymagają zastosowania i wyjaśnienia powodu, dla którego chcesz uzyskać dostęp do klucza. Firmy nie chcą, aby ich zasoby były zbyt obciążane, chyba że deweloper aktywnie wykorzystuje te zaproszenia do promowania własnych produktów i usług. Mogą nawet poprosić zespół o sprawdzenie Twojej prośby. Jeśli chcesz zapoznać się z technologią, poproś o dostęp ze strony Flickr, gdzie wymagania są niskie. Teraz będziesz mieć swój klucz i kod wraz z nim.
Uwierzytelnianie i API
Następnie zastanów się, czy chcesz używać interfejsu API do pobierania danych wymagających uwierzytelnienia. Na przykład, jeśli miałbyś korzystać z interfejsu API Facebooka lub Instagrama, który umożliwia publikowanie zdjęć i tekstu, musiałoby to zostać uwierzytelnione. Dlaczego to? Cóż, jeśli myślisz o tym w ten sposób, musisz mieć konto, aby normalnie publikować na Facebooku. Nie możesz zamieszczać anonimowo w serwisie. Podobnie, jeśli API publikuje w Twoim imieniu, musisz również zostać uwierzytelniony za pomocą nazwy użytkownika i hasła, aby się do niego dostać. To pozwoli Cię zidentyfikować, a publikowane treści będą odsyłać do Ciebie, jeśli zostaną opublikowane rzeczy, które nie powinny być.
Wiele systemów używa OAuth do uwierzytelniania, ponieważ protokół jest łatwy w użyciu i umożliwia użytkownikom prostą interakcję interfejsu API z witryną internetową jako serwerem proxy. Informacje są przesyłane bezpiecznym łączem, dzięki czemu tożsamość użytkownika nie jest ujawniana. Jednak nie zawsze musisz być uwierzytelniany.
Kładąc wszystko razem
Mamy teraz wszystkie elementy, których potrzebujemy, aby zacząć wykonywać wywołania API. W WordPressie otwórz Wygląd, a następnie Widgety. Są one napisane w PHP. Korzystając z dokumentacji interfejsu API, którą pobrałeś ze strony, wklej ją, aby rozpocząć składanie żądań. W przypadku korzystania z Flickr API adres URL będzie wyglądał jak https://flickr.com/services/rest
W kodzie, jeśli widzisz wiersz na klucz API, skopiuj go z miejsca, w którym o to poprosiłeś i otrzymałeś hasło i klucz. Gdy otrzymasz dane z powrotem z witryny, mogą one być w formacie HTML, XML, tekstowym lub JSON. Załóżmy, że nie znasz wszystkich tych formatów; w porządku. Wybierz taki, z którym będziesz mógł pracować i który będziesz mógł później tłumaczyć.

Patrząc na dane
Po zakończeniu wklejania potrzebnych informacji, aby uzyskać dane, będziesz także potrzebować pliku PHP lub pliku WordPress, aby odczytać dane i wyświetlić informacje na ekranie. Jeszcze raz wróć do dokumentacji API na stronie firmy, z którą współpracujesz. Powinien istnieć blok kodu, który wygeneruje dane w formacie, który można odczytać jako tekst lub wyświetlić jako obrazy w witrynie WordPress.
Formatowanie danych
Gdy zobaczysz, że dane pojawiają się w Twojej witrynie, mogą wyglądać dziwnie. Formatowanie to tylko surowy strumień danych. Kiedy wykonujesz wywołanie API do zewnętrznej witryny, nie ma próby formatowania go w sposób, który będzie ładnie wyglądał. Jeśli chcesz ukształtować dane w taki sposób, aby wyglądały reprezentacyjnie, możesz użyć pliku CSS, który jest ukierunkowany na dopracowanie wszystkiego. Jeśli masz problemy z pisaniem CSS, możesz znaleźć przykłady w Internecie, aby wskazać Ci kierunek. Skopiuj kod do pliku CSS, aby witryna WordPress miała do niego dostęp.
Wniosek
To był krótki samouczek dotyczący integracji interfejsu API z witryną WordPress. Temat jest złożony i może być trudny nawet podczas kopiowania kodu. Zamelduj się w niektórych witrynach internetowych, jeśli masz problemy i pamiętaj, aby wracać do Superb Themes, aby uzyskać więcej recenzji i samouczków.