W tym miejscu wyjaśniamy wszystko na temat (naszego) API, podając kilka ciekawych przykładów, jak z niego korzystać i dlaczego warto to robić.

API to skrót od Application Programming Interface (interfejs programowania aplikacji). Jest to interfejs umożliwiający komunikację między aplikacjami. Zasadniczo pozwala on wysłać żądanie lub zadać pytanie, po czym wywołanie API wykonuje przewidzianą czynność po otrzymaniu od użytkownika odpowiednich informacji.

Wyobraź sobie, że siedzisz przy stoliku w restauracji z menu, z którego możesz wybrać dania. Kuchnia to część „systemu”, która przygotuje Twoje zamówienie. Brakuje jednak kluczowego ogniwa, które przekaże Twoje zamówienie do kuchni i dostarczy jedzenie z powrotem do Twojego stolika. I tu właśnie wkracza kelner, czyli API. Kelner jest posłańcem – czyli API – który przyjmuje Twoje zamówienie i przekazuje kuchni – czyli systemowi – co ma zrobić. Następnie kelner dostarcza Ci odpowiedź; w tym przypadku jest to jedzenie.

Podsumowując, gdy firma udostępnia swoim klientom API, oznacza to po prostu, że stworzyła zestaw dedykowanych adresów URL, które zwracają czyste odpowiedzi w postaci danych — co oznacza, że odpowiedzi te nie zawierają elementów prezentacyjnych, których można by się spodziewać w graficznym interfejsie użytkownika, takim jak strona internetowa.

Mamy pięć wywołań API, które pełnią różne funkcje.

Wywołanie API składa się z trzech elementów:

Dane to informacje wysyłane do punktu końcowego, czyli dane niezbędne do dodania uczestnika.

Punkt końcowy to adres internetowy, na który wysyłane są informacje, a odpowiedź wskazuje, czy wywołanie API zakończyło się powodzeniem, czy nie.

Webhooki mogą być używane w połączeniu z wywołaniami API w celu zainicjowania różnych działań. Gdy zostanie wysłany webhook zawierający dane niezbędne do wykonania określonego wywołania API, wywołanie to zostanie zrealizowane, a uczestnik zostanie dodany. https://intercom-help.eu/easy-lms-eu/pl/articles/642802-jak-skonfigurować-integrację-przy-użyciu-naszych-webhooków-przez-Zapier" target="_blank" class="intercom-content-link">webhooki muszą być wysyłane z Twojego systemu do naszego punktu końcowego i musisz je samodzielnie skonfigurować w swoim systemie.

Poniższe akapity stanowią część fikcyjnego przypadku użycia, mającego na celu wyjaśnienie, w jaki sposób webhooki i API mogą ze sobą współpracować.

Kierownik działu kadr utworzył kurs dla początkujących oraz egzamin dla nowo zatrudnionych pracowników. Kierownik działu kadr chce, aby pracownicy odbyli kurs, ale dostęp do egzaminu mają uzyskać dopiero po jego ukończeniu. Dopiero po zdaniu egzaminu pracownicy mają uzyskać dostęp do Akademii, w której znajdują się kursy i egzaminy na poziomie średniozaawansowanym i eksperckim. Jak więc to skonfigurować?

Aby zrozumieć, jak to skonfigurować, ustaliliśmy już, że te webhooki i wywołania API będą wysyłane wewnętrznie w ramach systemu Easy LMS. Proces wygląda następująco.

Kierownik działu kadr musi utworzyć webhook, który po ukończeniu kursu przez pracownika wyśle ładunek do interfejsu API egzaminu. Webhook ten musi zawierać wyłącznie dane niezbędne do wywołania interfejsu API egzaminu. W tym przypadku korzystamy z wywołania API Dodaj uczestnika do Egzaminu (zaproszenie). Po wysłaniu tego webhooka wywołanie API zostanie uruchomione, jeśli otrzymana zostanie odpowiedź potwierdzająca powodzenie operacji. Wywołanie API dodaje uczestnika i automatycznie wysyła zaproszenie na Egzamin.

Drugi webhook, który musi utworzyć kierownik działu kadr, służy do sytuacji, gdy pracownik pomyślnie zda egzamin, aby uzyskać dostęp do Akademii. Również w tym przypadku ładunek tego webhooka powinien zawierać wyłącznie informacje potrzebne wywołaniu API Akademii do dodania uczestnika i wysłania zaproszenia. Po wysłaniu tego webhooka zostanie wywołane API Akademii, które następnie doda uczestnika do Akademii i wyśle zaproszenie.

Podsumowując:

Klient chce korzystać z naszego narzędzia do szkolenia swoich (nowych) pracowników. Obecnie korzysta z ustawienia Z góry zdefiniowana grupa uczestników do wysyłania e-maili z zaproszeniami. Jednak wielu pracowników postrzega te zaproszenia jako spam, a niektóre z tych wiadomości trafiają również do ich folderów ze spamem. Klient chce zamiast tego wysyłać te zaproszenia z własnego systemu.

Klient najpierw tworzy webhook, który wysyła dane do API egzaminu – dodaj uczestnika bez powiadamiania. Gdy nowy pracownik zostanie dodany do systemu klienta, webhook wysyła dane do API egzaminu, które dodaje pracownika. Wywołanie API nie wysyła zaproszenia do tego pracownika. Gdy wywołanie API zakończy się powodzeniem, odpowiedź zawiera dane logowania. Dane te muszą następnie zostać przesłane do pracownika z własnego systemu i aplikacji pocztowej.

Działa to również w przypadku obecnych pracowników – wystarczy utworzyć webhook, który wysyła dane do API egzaminu, co uruchamia akcję dodania uczestników bez powiadamiania o egzaminie. Dane logowania zwrócone w odpowiedzi na wywołanie API można następnie wysłać z własnego systemu.

Klient tworzy egzaminy w naszym systemie i sprzedaje je swoim klientom za pośrednictwem własnej witryny e-commerce. Chce zautomatyzować ten proces po dokonaniu przez klientów płatności za egzamin.

Aby zautomatyzować proces sprzedaży, klient będzie musiał skorzystać z webhooka. Gdy klienci klienta dokonają zakupu lub zapłacą za egzamin na jego stronie e-commerce, zostaną dodani do jego systemu. Webhook, który tworzy, musi zostać uruchomiony po dokonaniu płatności. Webhook ten wyśle następnie odpowiednie dane do wywołania API egzaminu i musi zwrócić odpowiedź potwierdzającą powodzenie lub błąd. Jeśli odpowiedź jest pozytywna, wywołanie API dodaje klientów i zaprasza ich do egzaminu, za który zapłacili.
​

Nasze API akceptuje formaty application/x-www-form-urlencoded, multipart/form-data oraz JSON.

Dowiedz się więcej z poniższych artykułów: