Co to jest API?

Jak agent AI korzysta z API

1. UprawnienieWłaściciel konta autoryzuje aplikację (OAuth) albo generuje klucz z ograniczonymi uprawnieniami.
2. ŻądanieAgent wysyła do API zapytanie, np. o zamówienia z wczoraj.
3. SprawdzenieSystem sprawdza uprawnienia i limity, a potem przygotowuje dane.
4. OdpowiedźAPI zwraca dane w formacie dla programów, a agent na ich podstawie wykonuje swoją pracę.

API w jednym akapicie

MDN, dokumentacja techniczna prowadzona przez Mozillę, opisuje API jako zestaw funkcji i reguł, który pozwala korzystać z programu przez inne oprogramowanie, a nie przez interfejs dla człowieka. To rodzaj umowy: system określa, o co można go zapytać i co odpowie. Człowiek klika w panelu sklepu, a program korzysta z API tego samego sklepu.

Jak działa API w internecie?

Większość API, z którymi łączą się agenci, działa przez HTTP, tak jak strony internetowe. Program wysyła żądanie na konkretny adres (tzw. endpoint), np. „lista zamówień z ostatniej doby”, a system odpowiada danymi, najczęściej w formacie JSON. Takie interfejsy często nazywa się REST API: dane są dostępne pod adresami i wymieniane przez standardowe żądania HTTP.

Każde API ma dokumentację, która opisuje dostępne adresy, wymagane parametry i limity, np. ile zapytań wolno wysłać w ciągu minuty. Gdy program przekroczy limit, system zwykle odrzuca kolejne zapytania, dlatego agent musi rozkładać pracę w czasie.

Klucz API, token i OAuth: jak program się loguje?

• Klucz API albo token: ciąg znaków generowany w ustawieniach konta. Działa jak hasło dla programu, więc trzyma się go w menedżerze sekretów, a nie w mailu czy w kodzie. Tak działa m.in. API BaseLinkera.
• OAuth: właściciel konta loguje się u dostawcy i zgadza się na dostęp aplikacji w określonym zakresie. Aplikacja dostaje token, a hasło zostaje u właściciela. Tak autoryzuje się aplikacje w Allegro REST API.
• Zakres uprawnień (ang. scopes): aplikacja dostaje tylko to, czego potrzebuje, np. sam odczyt zamówień.

API, webhook i serwer MCP: czym się różnią?

Przez API program sam pyta o dane wtedy, gdy ich potrzebuje. Webhook działa odwrotnie: system sam powiadamia program, gdy coś się wydarzy. Serwer MCP to warstwa nad API, która opisuje wybrane funkcje językiem zrozumiałym dla asystenta AI, np. Claude, i pilnuje, z których wolno mu korzystać.

Co to oznacza dla firmy?

Zanim firma zamówi agenta AI, warto sprawdzić, czy systemy, których używa, mają oficjalne API. Sklepy, marketplace’y, systemy do sprzedaży wielokanałowej i CRM-y zwykle je mają. Integracje robimy tylko przez oficjalne API, z autoryzacją zamiast przekazywania haseł. Agent dostaje na start uprawnienia tylko do odczytu, a działania zmieniające dane dochodzą wtedy, gdy są naprawdę potrzebne. Systemy, z którymi łączymy agentów: integracje.

Najczęstsze pytania

Czy każdy program ma API?

Nie. Większość popularnych sklepów, marketplace’ów i CRM-ów udostępnia API, ale część starszych programów go nie ma albo daje je tylko w wyższym planie. Wtedy zostaje eksport plików albo zmiana narzędzia.

Czy korzystanie z API jest płatne?

Zależy od dostawcy. Część systemów daje API w cenie konta, część w wyższych planach, a większość ma limity liczby zapytań. Osobną sprawą jest API modeli AI, za które płaci się według zużytych tokenów.

Czy przez API ktoś zobaczy wszystkie dane firmy?

Tylko w zakresie, na który pozwala klucz albo zgoda OAuth. Dlatego aplikacji daje się najmniejsze potrzebne uprawnienia, klucze trzyma w bezpiecznym miejscu i usuwa, gdy przestają być potrzebne.

Źródła

• MDN Web Docs: API (glossary)
• MDN Web Docs: REST (glossary)
• Allegro Developer Portal: uwierzytelnianie i autoryzacja (OAuth 2.0)