Diagnostykę zacznij od rozdzielenia trzech kwestii: czy adres API odpowiada, czy token jest przyjmowany i czy konkretna operacja jest dozwolona. Każda z tych prób sprawdza inny fragment konfiguracji.
Healthcheck bez tokena #
GET https://twoj-bs4.example/api/health
{"status":"ok","api":true,"version":"1.02"}Zachowaj podfolder, jeśli aplikacja jest w nim zainstalowana. Prawidłowy healthcheck API 1.02 zwraca HTTP 200 i obiekt bez otoczki results/success. Nie wymaga tokena, nie wykonuje operacji konektora i nie zużywa jego limitu wywołań. Inna metoda niż GET jest odrzucana.
Wynik nie potwierdza aktywności konkretnego konektora, poprawności tokena, uprawnień ani dostępności funkcji w licencji. Po healthchecku wykonaj mały, dozwolony odczyt danych. W starszym kodzie 1.01 istniał błąd przejścia z healthchecku do autoryzacji; jeśli tak zachowuje się instalacja, potrzebna jest aktualizacja.
Historia i szczegółowe logowanie #
Otwórz konektor i sprawdź jego historię oraz statystyki. Szczegółowe przyczyny błędów są zapisywane po stronie BS4. Na czas prac ustaw pole „Logowanie szczegółowe do dnia” na potrzebny termin. Dodatkowe wpisy mogą zawierać parametry żądań i szczegóły przetwarzania; ustaw krótki okres i udostępniaj historię tylko osobom pracującym nad integracją.
Kody odpowiedzi #
| HTTP w API 1.02 | Działanie |
|---|---|
| 400 | Sprawdź poprawność obiektu JSON, parametrów i walidację danych. |
| 401 | Sprawdź token, jego rodzaj oraz aktywność konektora. |
| 403 | Sprawdź listy klas, pól, zestawień i triggerów odpowiednie dla operacji. |
| 404 | Sprawdź alias klasy i istnienie obiektu lub definicji. |
| 405 | Sprawdź metodę żądania, zwłaszcza GET dla healthchecku. |
| 429 | Osiągnięto ograniczenie wywołań lub prób autoryzacji. Ogranicz częstotliwość i wróć do diagnozy przed ponowieniem. |
| 500 / 503 | Sprawdź historię i dostępność instalacji; przed ponowieniem operacji zapisu ustal jej rzeczywisty wynik. |
Wcześniejsze instalacje mogły zwracać błąd w errors przy HTTP 200. Program integracyjny powinien czytać zarówno status HTTP, jak i treść odpowiedzi. Wielkość limitów wywołań zależy od konfiguracji instalacji; nie wpisuj uniwersalnej stałej liczby do integracji.
Przekazanie problemu do obsługi #
Przygotuj godzinę wywołania, metodę, ścieżkę bez tokena, wersję API, status HTTP oraz zanonimizowaną treść błędu. Dla operacji zapisu dopisz, jaki stan potwierdziłeś w BS4.
