_
Wskazówki dotyczące łączenia się z interfejsem API
-
🛠️ Praktyczne wskazówki (lista kontrolna)
- Pole adresu URL (wymagane) : Skopiuj i wklej cały adres URL bez spacji. Musi zaczynać się od https://.
- Klucz nosiciela : Wprowadź tylko token (bez prefiksu Bearer). W przypadku Make/Zapier pozostaw puste pole.
- Mapowanie : Wpisz dokładną nazwę JSON (uwzględniając wielkość liter). Np. name (nie Name).
- Kluczowe ciało : Pozostaw puste w 95% przypadków; używaj tego tylko jeśli wymaga tego API.
- Test : Zawsze testuj przy użyciu danych fikcyjnych (np. nazwa="TEST", adres e-mail="test@test.com").
- Dzienniki : Sprawdź ustawienia docelowe (Make, Zapier lub API), aby zdiagnozować problem.
- Bezpieczeństwo : Nigdy nie udostępniaj publicznie kluczy webhook ani adresów URL.
🔒 Bezpieczeństwo
- Traktuj swoje webhooki jak hasła.
- Używać HTTPS wyłącznie.
- Wygeneruj ponownie adres URL webhooka, jeśli został naruszony.
- Jeśli to możliwe, używaj kluczy z ograniczonymi uprawnieniami.
🆘 Szybkie rozwiązywanie problemów
Wydanie
Prawdopodobna przyczyna
Rozwiązanie
Błąd 401
Nieprawidłowy lub brakujący token okaziciela
Zweryfikuj tajny klucz nośnika (bez spacji, poprawny)
Błąd 404
Nieprawidłowy adres URL
Skopiuj i wklej ponownie cały adres URL
Błąd 500
Problem po stronie serwera odbiorczego
Sprawdź logi odbiorcy
Brak odpowiedzi
Adres URL nieaktywny / usługa zatrzymana
Sprawdź, czy webhook/API jest aktywny
Brak danych
Złe mapowanie
Sprawdź poprawność pisowni nazw JSON
Nieprawidłowy format
Niezgodny typ danych
Sprawdź oczekiwane typy (tekst, liczba…)
📞 Potrzebujesz pomocy?
- Własnościowe API : Skonsultuj się ze swoim programistą lub dokumentacją interfejsu API.
- Make : https://www.make.com/pl/pomoc
- Zapier : https://help.zapier.com/