API
Sposób, w jaki programy łączą się z modelem AI - „wtyczka” do budowania własnych aplikacji.
API, czyli interfejs programowania aplikacji, to ustalony sposób, w jaki jeden program korzysta z funkcji lub danych drugiego programu bez ręcznego klikania w jego interfejs.
Polski sklep może przez API pobrać kurs euro z NBP i pokazać go w swoim panelu. Pracownik nie przepisuje liczby ze strony, tylko otrzymuje uporządkowaną odpowiedź z kodem waluty, datą i kursem. To dobry przykład na start, bo nie wymaga modelu AI ani przesyłania danych klientów. Samo API nie oznacza sztucznej inteligencji.
Jak wygląda pierwsze zapytanie do API
Otwórz w przeglądarce adres https://api.nbp.pl/api/exchangerates/rates/a/eur/?format=json. To publiczny endpoint NBP, czyli adres konkretnej funkcji: odczytu ostatniego dostępnego kursu średniego EUR z tabeli A. Odpowiedź zawiera między innymi pole effectiveDate z datą publikacji i mid z kursem. W weekend nie musi to być data dzisiejsza.
Takie pobranie danych jest żądaniem GET. Program może wykonać je automatycznie i odczytać potrzebne pola z JSON, czyli tekstowego formatu danych. Przy wysyłaniu treści do modelu AI często używa się POST: oprócz adresu dochodzą nagłówki i treść żądania. Dokładny format zawsze ustala dostawca. Dokumentacja NBP opisuje parametry, zakresy dat i odpowiedzi błędów.
Do ćwiczenia wybierz jeden kurs i jedną datę. Sprawdź, co aplikacja zrobi, gdy odpowiedź nie nadejdzie albo wskazana tabela jeszcze nie istnieje. Nie podstawiaj wówczas zera, bo zero wygląda jak poprawna liczba. Pokaż brak danych lub ostatni odczyt z jego datą. To ważniejsza umiejętność niż samo skopiowanie działającego adresu.
Do czego API przydaje się przy AI
Przykładowo mała firma dostaje wiadomości po polsku i chce dzielić je na pytania o dostawę, zwroty i pozostałe sprawy. Jej program może przesłać zanonimizowany tekst do modelu i poprosić o jedną kategorię. Potem zapisze wynik w panelu. Odpowiedź modelu nadal wymaga sprawdzenia: ma trafić do dozwolonego zestawu kategorii, a nie bezpośrednio uruchamiać zwrot pieniędzy.
API pozwala zintegrować model z własnym formularzem, arkuszem lub aplikacją. Nie gwarantuje jednak poprawności odpowiedzi. Czat dostępny w przeglądarce i API dostawcy mogą mieć inne rozliczenia, limity i zasady dostępu. Zanim połączysz usługę z firmowymi danymi, sprawdź właśnie warunki API, a nie wyłącznie ofertę abonamentu czatu.
Jak uruchomić integrację krok po kroku
Ustal jedną czynność i format wyniku. Na początek wystarczy sklasyfikowanie pięciu przykładowych wiadomości, bez nazwisk i danych zamówień.
Sprawdź dokumentację uwierzytelniania. Jeśli potrzebny jest klucz API, przechowuj go po stronie serwera. Nie wklejaj go do publicznego kodu strony, zrzutów ekranu ani repozytorium. Nie wszystkie API wymagają klucza - powyższy odczyt NBP go nie potrzebuje.
Ustaw limit czasu i obsługę błędów. Odpowiedź 401 zwykle oznacza problem z uwierzytelnieniem, a 429 przekroczenie ograniczeń. Szczegóły odczytaj z dokumentacji i komunikatu. Nie ponawiaj płatnego żądania bez końca; po przerwaniu połączenia usługa mogła już je wykonać.
Zapisuj koszt, status i czas wykonania, ale nie sekrety ani pełną treść prywatnych wiadomości. Ogranicz liczbę prób, długość wejścia i maksymalny wynik. Sprawdź, czy limit wydatków u dostawcy blokuje operacje, czy tylko wysyła powiadomienie.
Przetestuj pusty tekst, brak sieci i niepoprawną odpowiedź. Do działania na większej liczbie rekordów przejdź dopiero po kontroli małej próbki.
Najczęstszy błąd: API traktowane jak gotowa aplikacja
API daje dostęp do funkcji, ale nie buduje całego procesu. Ktoś musi sprawdzić dane wejściowe, obsłużyć odmowę usługi, zabezpieczyć klucz i zdecydować, co zrobić z wynikiem. Biblioteka lub SDK ułatwia napisanie tego kodu; nie jest inną nazwą API. Różnicę między interfejsem a biblioteką wyjaśnia wprowadzenie MDN.