API (Application Programming Interface)

API to standardowy interfejs, który pozwala dwóm programom rozmawiać ze sobą. Określa dokładnie, jakie dane jeden program może poprosić i w jakiej formie otrzyma odpowiedź — niczym kelner krążący między gościem (Państwa oprogramowaniem) a kuchnią (naszą platformą).

Czym jest API?

API to skrót od «Application Programming Interface» (interfejs programowania aplikacji). API to uzgodniony język, którego dwa systemy używają do wymiany informacji. Nie jest programem, którym się obsługujemy, lecz umową: «Jeśli wyślesz mi A, odeślę ci B».

Wyobraźmy sobie restaurację. Jako gość nie wchodzą Państwo do kuchni. Rozmawiają z kelnerem. Kelner zna menu (= dokumentację API), przyjmuje zamówienie w ustalonej formie («makaron z sosem pomidorowym») i przynosi rezultat. Kuchnia może się zmieniać — nowi kucharze, nowy sprzęt — i dopóki kelner trzyma się tego samego menu, Państwa doświadczenie pozostaje takie samo. Dokładnie w ten sposób API oddziela to, o co prosi Państwa oprogramowanie, od tego, jak usługa pod spodem to dostarcza.

Dlaczego API są ważne

API stanowią niewidzialny szkielet nowoczesnego oprogramowania. Gdy Państwa narzędzie księgowe rozmawia ze Stripe, gdy sklep internetowy sprawdza stany magazynowe w czasie rzeczywistym, gdy strona osadza Google Maps — w tle pracuje API. Bez API każda firma musiałaby budować każdą funkcjonalność samodzielnie. Z API składa się wyspecjalizowane usługi jak klocki.

API w kontekście SendSeven

SendSeven udostępnia API, dzięki któremu Państwa oprogramowanie może wysyłać wiadomości, zarządzać kontaktami i czytać rozmowy — w WhatsApp, SMS, e-mailu, Telegramie, Instagramie, Messengerze i live chacie. Trzy konkretne przykłady:

  • Sklep internetowy: Po każdym zamówieniu sklep automatycznie wysyła potwierdzenie na WhatsApp — bez ręcznego wpisywania.
  • CRM: W momencie, gdy lead przechodzi w status «gorący», CRM uruchamia spersonalizowaną wiadomość w kanale preferowanym przez klienta.
  • Helpdesk: Przychodzące wiadomości WhatsApp lądują jako tickety w Państwa systemie helpdesk — przez webhook w drugą stronę.

Typy API

Nie każde API działa tak samo. Najczęstsze warianty:

  • REST API: Dzisiejszy standard dla API webowych. Używa HTTP jak przeglądarka, łatwy w użyciu, wspierany przez każdy zestaw programistyczny. SendSeven korzysta z REST.
  • GraphQL: Wariant, w którym klient sam określa, jakie pola chce dostać w odpowiedzi. Bardziej efektywny dla złożonych modeli danych.
  • WebSocket: Do połączeń w czasie rzeczywistym, gdzie serwer sam wysyła zdarzenia (np. «odebrano nową wiadomość»).
  • MCP Server: Nowszy typ interfejsu, zaprojektowany specjalnie dla agentów AI, takich jak Claude czy GPT.

Uwierzytelnianie: kto co może?

API nie są otwarte publicznie. Każde wywołanie musi się przedstawić. SendSeven używa klucza API — sekretnego, osobistego tokena działającego jak hasło. Kto ma klucz, może działać w Państwa imieniu. Dlatego klucz API nigdy nie powinien trafić do frontendu, do publicznego repozytorium GitHub ani do e-maila.

Co się dzieje, gdy coś idzie nie tak?

Każde API odpowiada kodem statusu. 200 OK oznacza, że wszystko w porządku. 401 oznacza, że uwierzytelnianie się nie powiodło. 429 oznacza zbyt wiele żądań — zob. rate limiting. 500 oznacza błąd po stronie serwera. Dobra integracja sprawdza kod statusu i reaguje rozsądnie — na przykład ponawia próbę po krótkiej pauzie.

API vs konektor vs SDK

Te trzy pojęcia często się myli:

  • API: Surowy interfejs — wywołania HTTP, odpowiedzi JSON. Wymaga wiedzy programistycznej.
  • SDK: Gotowa biblioteka (w Pythonie, JavaScript, PHP…) upraszczająca API dla programistów.
  • Konektor: Gotowa integracja z konkretnym systemem zewnętrznym (np. konektor Shopify). Często do użycia bez kodowania.

Czy MŚP potrzebuje API?

Krótka odpowiedź: tylko gdy chce się zautomatyzować coś, czego nie można zrobić od ręki. SendSeven oferuje trzy drogi, zależnie od zaawansowania technicznego:

  1. Platforma: Klikanie zamiast kodu — domyślne rozwiązanie dla obsługi klienta i marketingu.
  2. Konektory: Gotowe integracje z Shopify, HubSpot, Zapier itd. — zwykle bez kodu.
  3. API: Do nietypowych workflow, własnego oprogramowania lub operacji masowych.