Połącz skrypt lub aplikację z zewnętrznym REST API i obsłuż autoryzację oraz błędy

Przełóż dokumentację cURL z systemu fakturowego, kurierskiego, Allegro, NBP lub OpenAI na działający kod z obsługą paginacji, limitów 429 i ponawiania zapytań.

W następnym kroku dodasz zdjęcie lub plik PDF w oknie rozmowy

Cztery filary niezawodnej integracji z zewnętrznym API

  1. 01

    Zawsze ustawiaj jawny parametr limitu czasu połączenia (Timeout)

    Wiele bibliotek HTTP domyślnie czeka w nieskończoność na zawieszony serwer zewnętrzny — ustaw timeout np. na 10 sekund, aby nie zablokować własnej aplikacji.

  2. 02

    Przekazuj klucze autoryzacyjne wyłącznie przez zmienne środowiskowe

    Nigdy nie wpisuj kluczy Bearer ani Basic Auth na sztywno w kodzie ani w kodzie JavaScript wykonywanym po stronie przeglądarki użytkownika.

  3. 03

    Obsłuż limity zapytań HTTP 429 z wykładniczym wyczekiwaniem (Backoff)

    Gdy zewnętrzny serwis zwróci 429 Too Many Requests, odczytaj nagłówek Retry-After i odczekaj kilka sekund przed ponowieniem próby.

  4. 04

    Zadbaj o idempotentność przy wysyłaniu płatności i dokumentów

    Zapisuj identyfikator wysłanego zamówienia lub używaj nagłówka Idempotency-Key, aby ponowienie po błędzie sieci nie wystawiło klientowi dwóch faktur.

Najczęściej zadawane pytania

Dlaczego nie wolno wywoływać płatnego API (np. OpenAI lub systemu CRM) bezpośrednio z frontendu React?

Każdy użytkownik może nacisnąć F12 w przeglądarce i w zakładce Sieć odczytać Twój tajny klucz API z nagłówków zapytania — takie wywołania muszą przechodzić przez Twój własny lekki backend.

Czym różni się błąd HTTP 401 Unauthorized od kodu HTTP 403 Forbidden?

Kod 401 oznacza brak poprawnego uwierzytelnienia (wygasły lub błędny token), natomiast 403 oznacza, że serwer rozpoznał Twoje konto, ale ten klucz nie ma uprawnień (scope) do danego zasobu.

Jak przetestować odbieranie webhooków z zewnętrznego serwisu na lokalnym komputerze localhost?

Zewnętrzny serwer nie widzi Twojego localhosta — użyj bezpiecznego tunelu deweloperskiego (np. Cloudflare Tunnel lub ngrok), który wygeneruje tymczasowy publiczny adres HTTPS przekierowany na Twój port.

Dowiedz się więcej

Powiązane poradniki i wyjaśnienia do tego zadania

Znajdź przyczynę błędu ze zrzutu stack trace w Pythonie, JavaScript lub C#

Wklej komunikat wyjątku i fragment funkcji, aby szybko zrozumieć, dlaczego zmienna przyjmuje wartość null/None, skąd bierze się błąd typów lub problem asynchroniczny.

Napisz złożone zapytanie SQL lub przyspiesz wolno działający raport bazodanowy

Prześlij strukturę tabel (CREATE TABLE) lub plan wykonania EXPLAIN ANALYZE, aby zbudować poprawne złączenia JOIN, funkcje okna i właściwe indeksy wielokolumnowe.

Zbuduj makro VBA lub zaawansowaną formułę automatyzującą pracę w Excelu

Zastąp ręczne przeklejanie tabelek jednym przyciskiem: wygeneruj kod VBA, transformację Power Query lub formułę X.WYSZUKAJ / Google Apps Script pod dokładny układ kolumn.

Napisz skrypt PowerShell lub Bash do masowej obróbki plików i zadań administracyjnych

Zautomatyzuj masową zmianę nazw tysięcy zdjęć, czyszczenie starych logów, konwersję obrazów lub zadania cykliczne w Harmonogramie zadań Windows i linuksowym cronie.

Rozwiąż konflikt scalania gałęzi w Git lub cofnij błędny commit bez utraty kodu

Wklej wynik git status, zanim wpiszesz ryzykowne --hard lub --force: odzyskaj skasowane zmiany przez git reflog, wyczyść zacommitowany plik .env i uporządkuj gałęzie.

Przygotuj plik Dockerfile oraz docker-compose.yml i napraw błędy konteneryzacji

Wklej swój plik docker-compose.yml lub logi kontenera, aby rozwiązać problem z połączeniem między aplikacją a bazą danych (localhost vs nazwa usługi), uprawnieniami woluminów i rozmiarem obrazu.