Integracje API

Każdy poważny produkt prędzej czy później zaczyna rozmawiać z innymi systemami: bramki płatności, CRM, dostawcy wysyłki, analityka, usługi AI. Budujemy te integracje tak, by przetrwały realne warunki — rate limity, timeouty, niestabilne API stron trzecich i dane w takim kształcie, w jakim druga strona je wyśle.

Integracje, które dostarczyliśmy

• CRM i sprzedaż — formularze tej strony wysyłają leady do Zoho CRM z obsługą błędów, więc awaria Zoho nigdy nie gubi zapytania.
• Płatności — Stripe i inne bramki: checkout, subskrypcje, webhooki, rekonsyliacja.
• Providerzy AI — NetPostPanel orkiestruje wiele API LLM za jednym wewnętrznym interfejsem z retry i fallbackami.
• REST i GraphQL API — konsumujemy zewnętrzne API i budujemy udokumentowane endpointy dla partnerów i aplikacji mobilnych.
• Webhooki — przychodzące i wychodzące, z weryfikacją podpisów i przetwarzaniem odpornym na powtórki.

Zbudowane na graceful failure

public function handle(Request $request): JsonResponse
{
    abort_unless(
        hash_equals($expected, $request->header('X-Signature')),
        401
    );

    ProcessWebhook::dispatch($request->all())->onQueue('webhooks');

    return response()->json(['status' => 'accepted'], 202);
}

Zweryfikuj, dodaj do kolejki, potwierdź. Nadawca dostaje 202 w milisekundach; właściwa praca bezpiecznie ponawia się w tle.

Kolejki zamiast synchronicznych wywołań, retry z backoff, przetwarzanie idempotentne (dwukrotnie dostarczony webhook niczego nie zmienia), widoczność dead-letter i ślady audytu — gdy strona trzecia leży o trzeciej w nocy, Twoi użytkownicy tego nie zauważają i nic nie ginie.

Jak przebiega projekt integracji

Zaczynamy od kontraktów, a nie kodu: czytamy dokumentację API dostawcy, mapujemy przepływy danych, ustalamy właściciela każdego pola. Potem cienka warstwa integracyjna — osobna klasa serwisowa na dostawcę — trzyma cudze kaprysy poza kodem domeny. Najpierw sandbox, po starcie monitoring i dokumentacja dla kolejnego zespołu.

Jeśli Twoje systemy żyją w silosach, a ludzie przeklejają dane między nimi ręcznie — da się to naprawić. Powiedz, co ma z czym rozmawiać.