Połącz swoje systemy: integracja API i webhooki
Piszemy kod, który przerzuca dane między twoimi systemami automatycznie — z logiem, ponowieniami i alertem, gdy coś pójdzie nie tak.
Co dostajesz
- Działający kod integracjiSkrypt w Pythonie (requests/FastAPI) lub Node.js, klucze w pliku .env poza kodem, obsługa błędów, retry z backoffem i limit zapytań dopasowany do rate limitu API.
- Endpoint webhooka z weryfikacjąAdres HTTP przyjmujący zdarzenia, sprawdzanie podpisu (zwykle HMAC SHA-256), odpowiedź 200 poniżej 5 s i klucz idempotencji, żeby powtórzone zdarzenie nie wykonało akcji dwa razy. W najprostszym wariancie zamiast webhooka dane pobiera cron.
- Mapowanie pólTabela XLSX: pole źródłowe → pole docelowe, z ustaloną obsługą dat, kwot, VAT, NIP i pól, których po prostu nie ma po drugiej stronie.
- Logi i alert o awariiKażdy przebieg zapisany do pliku lub arkusza, a przy błędzie powiadomienie na e-mail lub WhatsApp — żebyś nie dowiedział się o awarii od swojego klienta.
- README i wdrożenie po twojej stronieInstrukcja krok po kroku: gdzie postawić kod (VPS, Railway, Render, serwer firmowy), jak ustawić cron, jak podmienić klucze bez naszej pomocy. Docelowy serwer uruchamiasz ty — jeśli mamy postawić infrastrukturę za ciebie, to osobna wycena.
Czego potrzebujemy od ciebie
Im więcej podasz od razu, tym szybciej dostaniesz wycenę. Brakujące rzeczy dopytamy jednym pytaniem.
- Link do dokumentacji obu API — albo zrzuty z panelu, jeśli dokumentacja jest tylko tam.
- Jedno zdanie: co ma wyzwalać akcję i co ma się stać, np. „nowe zamówienie w sklepie → faktura w Fakturowni".
- Klucze API — najlepiej testowe/sandbox, jeśli dostawca je udostępnia.
- Przykład realnych danych: 1–2 rekordy w JSON lub CSV (zamówienie, lead, faktura), żeby wiedzieć, jak wygląda payload.
- Gdzie to ma docelowo działać: VPS, Railway/Render, n8n, serwer firmowy — albo napisz, że nie wiesz, i dobierzemy.
Jak to przebiega
Sprawdzamy API i wyceniamy
Czytamy dokumentację obu stron i sprawdzamy, czy da się zrobić to, o co prosisz. Stała cena zwykle w 15 minut. Jeśli API nie ma potrzebnej funkcji, mówimy o tym od razu i nie bierzemy zlecenia.
Prototyp na danych testowych
Budujemy jeden przepływ end-to-end na twoim przykładowym rekordzie i wrzucamy log z przebiegu do grupy WhatsApp. Widzisz, co dokładnie wpadło do systemu docelowego, zanim cokolwiek ruszy na produkcji.
Test na żywo
Integrację uruchamiamy na naszym środowisku i podpinamy ją pod twoje konto testowe — albo produkcyjne, jeśli dostawca nie daje sandboxa. Przepuszczamy realne zdarzenie i sprawdzamy scenariusze awaryjne: brak odpowiedzi, duplikat zdarzenia, przekroczony limit zapytań.
Przekazanie
Dostajesz kod, README, mapowanie pól i log z ostatniego przebiegu. Uruchomienie na docelowym serwerze idzie po twojej stronie według instrukcji; na pytania z wdrożenia odpowiadamy w grupie WhatsApp do zamknięcia zlecenia.
Poza tym zakresem — prowadzi człowiek
Te rzeczy też robimy, ale wychodzą poza stałą cenę. Przejmuje je Paweł, wycena indywidualna.
- Migracja całej bazy danychPrzeniesienie kompletu danych między systemami z mapowaniem, testami i planem wycofania. Skala i ryzyko wymagają rozmowy przed wyceną.
- Integracja ERP na wiele modułówSpięcie magazynu, sprzedaży i księgowości w jeden przepływ. Projekt na tygodnie, prowadzony przez człowieka od analizy po odbiór.
- Monitoring i dyżur 24/7Reagowanie na awarie także w nocy i w weekend, z gwarantowanym czasem odpowiedzi. Usługa ciągła, rozliczana abonamentem.
- Konfiguracja hostingu i infrastrukturyPostawienie VPS-a, Dockera, domeny i certyfikatów pod twoją integrację. Robimy, ale rachunki u dostawców zostają po twojej stronie.
Częste pytania
Czy ten kod pisze AI i czy to widać?
Kod pisze agent AI, człowiek go czyta i uruchamia. W samym kodzie tego nie widać — widać tylko, czy przepływ działa. Każdą integrację przed oddaniem puszczamy na realnym payloadzie z twojego systemu i dostajesz log z tego przebiegu. Jeśli nie przechodzi testu, nie oddajemy jej.
A jeśli okaże się, że tego API po prostu nie da się podpiąć?
Sprawdzamy dokumentację przed wyceną. Jeśli API nie ma potrzebnego endpointu albo nie pozwala na to, co chcesz zrobić — mówimy o tym przed zapłatą i nie bierzemy zlecenia. Zdarza się to najczęściej przy starszych systemach magazynowych i panelach bez publicznego API.
Mój system nie ma webhooków. Da się coś zrobić?
Zwykle tak — zamiast czekać na zdarzenie, odpytujemy API co 5–15 minut (cron) i pamiętamy ostatni pobrany rekord. Dane lecą z opóźnieniem, ale przepływ jest stabilny. To wariant z dolnej części widełek.
Co, jeśli integracja zdubluje faktury albo wyśle dane do złego kontrahenta?
Dlatego każde zdarzenie ma klucz idempotencji: powtórka tego samego zamówienia nie tworzy drugiej faktury. Zanim przełączysz przepływ na produkcję, przechodzi on przebieg na danych testowych, a przy pierwszym uruchomieniu na żywo trzymamy limit przetwarzanych rekordów — wynik po drugiej stronie sprawdzasz ty i to ty decydujesz o zdjęciu limitu. Jeśli mimo to zawini nasz kod, poprawiamy go bez dopłaty, a odpowiedzialność za szkodę ograniczamy do wysokości wynagrodzenia za to zlecenie (nie dotyczy to winy umyślnej). Nie odpowiadamy za zmiany wprowadzone w kodzie po odbiorze ani za awarie po stronie dostawców API.
Integracja nie robi tego, co ustaliliśmy — kto to poprawia?
Rozdzielamy dwie sytuacje. Jeśli przepływ nie działa tak, jak zapisaliśmy w ustaleniach na starcie, to wada po naszej stronie: poprawiamy bez dopłaty i bez limitu rund, bo to dokończenie zlecenia, a nie poprawka. Jedna runda zmian kosmetycznych (nazwy pól, format daty, treść alertu) też jest w cenie. Nowy system, nowa akcja albo zmiana formatu odpowiedzi po stronie dostawcy to osobne, zwykle drobne zlecenie. Kod dostajesz w plikach źródłowych, bez blokad i bez zależności od nas — może go rozwijać dowolny programista. Pozostałe zasady rozliczeń: /zasady/
Skąd wiem, że to nie padnie za dwa tygodnie?
Nie wiesz i my też nie. Integracja ma retry, logi i alert, więc dowiesz się od razu, gdy coś przestanie chodzić — nie po miesiącu, przy zamykaniu księgowości. Ale dostawcy zmieniają swoje API bez pytania: jak zmienią format odpowiedzi, trzeba poprawić kod i to jest osobne, tanie zlecenie.
Czy moje klucze API i przykładowe dane są bezpieczne?
Klucze trzymamy w pliku .env, nigdy w kodzie, i prosimy najpierw o dostępy sandbox/testowe, jeśli dostawca je daje. Dokumentacja i przykładowe payloady przechodzą przez model AI dostawcy zewnętrznego — bez tego usługa nie mogłaby powstać. Nie trafiają do zbiorów treningowych. Pliki robocze kasujemy 30 dni po odbiorze, wcześniej na twoją prośbę. Jeśli w przykładowych rekordach są dane osobowe, napisz przed wysyłką — podpiszemy umowę powierzenia, a pliki przyjmiemy linkiem do dysku zamiast WhatsAppem. Po zakończeniu zlecenia zrotuj klucze, które przeszły przez czat: to standardowa higiena, niezależnie od tego, kto robi wdrożenie.
Podobne zlecenia
Opisz zlecenie jednym zdaniem
Agent odpisze z ceną i terminem, zwykle w kwadrans. Nie pasuje — nic nie płacisz.
Każdą wiadomość agenta poznasz po znaczniku [AGENT].