Integracja API

Integracja API sprawia, że systemy w Twojej firmie zaczynają ze sobą rozmawiać. Zamiast przepisywać dane z jednego okna do drugiego, dane przepływają same — automatycznie, o ustalonej porze albo natychmiast po zdarzeniu.

Po czym poznać, że brakuje integracji

• Ktoś w firmie codziennie przepisuje te same dane między dwoma programami.
• Ta sama informacja istnieje w kilku miejscach i w każdym jest trochę inna.
• Raport miesięczny powstaje przez ręczne sklejanie eksportów w arkuszu.
• Klient dostaje potwierdzenie dopiero wtedy, gdy ktoś zdąży je wysłać.
• Błędy w danych biorą się z literówek, a nie z awarii.

Każda z tych sytuacji to koszt: godziny pracy, opóźnienia i pomyłki, których nikt nie planuje w budżecie.

Co integrujemy

Microsoft 365 i Microsoft Graph

Najczęstszy obszar u naszych klientów. Przez Microsoft Graph API automatyzujemy zakładanie i wyłączanie kont, przypisywanie licencji, tworzenie zespołów Teams, wysyłkę powiadomień, pobieranie danych z kalendarzy i porządkowanie plików w SharePoint. To naturalne rozwinięcie usług Microsoft 365.

Systemy dziedzinowe i sklepy internetowe

Wymiana zamówień, stanów magazynowych, cenników i dokumentów między aplikacją firmową, sklepem a systemem magazynowym. Tam, gdzie system nie ma API, wykorzystujemy eksport i import plików CSV lub Excel po harmonogramie.

Usługi zewnętrzne

• Firmy kurierskie — nadawanie przesyłek, etykiety, śledzenie statusów.
• Bramki płatności — inicjowanie płatności i odbieranie potwierdzeń.
• Rejestry publiczne — pobieranie danych firm po numerze NIP i weryfikacja rachunków bankowych na białej liście VAT.
• Systemy dostawców — cenniki, dostępność, składanie zamówień. Nasz portal B2B pobiera w ten sposób ofertę licencji i realizuje zamówienia po stronie dystrybutora.

Powiadomienia i komunikacja

Automatyczne wiadomości e-mail, powiadomienia w Microsoft Teams, SMS-y przy zdarzeniach wymagających reakcji — zamiast pilnowania skrzynki.

Jak wygląda wymiana danych

Sposób	Kiedy się sprawdza
REST API	Standard w nowoczesnych systemach. Pobieranie i zapis danych na żądanie, w formacie JSON.
Webhook	Gdy reakcja ma być natychmiastowa. System sam powiadamia o zdarzeniu, zamiast czekać na odpytanie.
SOAP	Starsze systemy i część rejestrów publicznych. Nadal powszechne, obsługujemy.
Wymiana plikowa	Gdy system nie ma API. Import i eksport CSV lub Excel po harmonogramie, przez FTP lub katalog sieciowy.
Bezpośrednio na bazie	Ostateczność, gdy nie ma innej drogi — z zachowaniem szczególnej ostrożności, patrz integracje baz danych.

Na czym zwykle wykłada się integracja

Zestawienie połączenia to najmniejsza część pracy. Problemy pojawiają się później i to o nie pytamy na starcie:

• Co, gdy druga strona nie odpowiada? Integracja musi ponawiać próby i kolejkować dane, a nie gubić je po pierwszym błędzie.
• Co przy podwójnym wysłaniu? Ponowienie nie może utworzyć drugiego zamówienia. Stosujemy klucze idempotentne.
• Kto się dowie o awarii? Cicho zepsuta integracja jest gorsza od jej braku — dane rozjeżdżają się tygodniami, zanim ktoś zauważy. Wdrażamy monitoring i alerty.
• Limity zapytań. Dostawcy API ograniczają liczbę wywołań; przekroczenie limitu blokuje wymianę.
• Zmiana wersji API po drugiej stronie. Integracja wymaga opieki, nie jest jednorazowym wdrożeniem.
• Które dane są źródłem prawdy? Gdy ten sam rekord da się zmienić w dwóch systemach, trzeba z góry ustalić, który wygrywa.

Bezpieczeństwo integracji

• Klucze i sekrety poza kodem — w zmiennych środowiskowych lub magazynie sekretów, nigdy w repozytorium.
• Konta techniczne z minimalnymi uprawnieniami, osobne dla każdej integracji, z możliwością szybkiego odcięcia.
• Szyfrowana transmisja i weryfikacja podpisów przy odbieraniu webhooków.
• Rejestr wywołań — co, kiedy i z jakim skutkiem, na potrzeby diagnostyki i audytu.
• Ograniczenie zakresu danych do tego, co faktycznie potrzebne — wymóg RODO i zdrowy rozsądek.

Jak pracujemy

1. Rozpoznanie. Sprawdzamy dokumentację obu stron i to, czy API rzeczywiście udostępnia potrzebne dane. Zdarza się, że nie — lepiej wiedzieć to przed wyceną.
2. Projekt przepływu. Co, w którą stronę, jak często, co przy błędzie, kto jest źródłem prawdy.
3. Środowisko testowe. Integrację uruchamiamy najpierw na danych testowych, nigdy od razu na produkcji.
4. Wdrożenie i obserwacja. Pierwsze dni pod nadzorem, z włączonym szczegółowym logowaniem.
5. Utrzymanie. Monitoring, reakcja na zmiany po stronie dostawcy, raporty z wykonania.

Najczęstsze pytania

Nasz system nie ma API. Da się coś zrobić?

Zwykle tak. Kolejność, którą sprawdzamy: udokumentowane API, niedokumentowane API używane przez interfejs webowy, eksport i import plików, dostęp do bazy danych. Któraś z tych dróg jest dostępna w większości przypadków.

Ile trwa integracja?

Prosta wymiana w jedną stronę z dobrze udokumentowanym API — zwykle kilka dni. Dwukierunkowa synchronizacja z obsługą konfliktów i błędów — od dwóch tygodni wzwyż. Najwięcej czasu pochłania nie kod, lecz ustalenie reguł biznesowych.

Czy integracja obciąży nasze systemy?

Przy poprawnym projekcie obciążenie jest znikome — pobieramy tylko zmiany, a nie całe zbiory. Ciężkie operacje planujemy poza godzinami pracy.

Co, gdy dostawca zmieni API?

Dlatego integracja powinna być objęta opieką. Monitorujemy poprawność wymiany i reagujemy na zmiany. Bez tego integracja prędzej czy później przestanie działać — i zwykle dowiesz się o tym od klienta.

Warto przeczytać

• REST, webhook czy plik — jak wybrać sposób wymiany danych
• Microsoft Graph API — automatyzacja zadań w Microsoft 365