Menu dokumentacji

API dzienników#

Odczyt dzienników wymaga zakresu data:read. Odpowiedzi są ograniczone do organizacji danych uwierzytelniających typu bearer i zawierają ograniczone kolekcje uporządkowane od najnowszych wpisów.

Błędy źródeł#

GET/sources/{id}/errors

Zwraca ostatnie skategoryzowane błędy jednego źródła. Parametr limit musi mieścić się w limicie endpointu. Odpowiedź nie zawiera danych uwierzytelniających ani surowych komunikatów miejsca docelowego, które mogłyby obejmować dane klienta.

Niedostępne źródło zwraca 404 source_not_found, tak samo jak nieznany identyfikator.

Zmiany schematu#

GET/schema-changes

Zwraca ostatnie niepuste różnice schematów. Użyj source=<source_id>, aby filtrować według źródła, oraz limit, aby ograniczyć odpowiedź.

Zmiana zawiera dotkniętą tabelę oraz dodane, usunięte lub zmienione kolumny. Jest sygnałem do sprawdzenia ścisłych projekcji i kontraktów typów modeli przed następnym wymuszonym uruchomieniem.

Zastosowanie operacyjne#

Odczytuj dzienniki po ostatecznym niepowodzeniu synchronizacji albo najpierw śledź postęp źródła przez API synchronizacji. Automatyzacja nie powinna analizować tekstu komunikatu przeznaczonego dla człowieka. Interfejsem maszynowym są stabilne kategorie, kody, identyfikatory i znaczniki czasu.

Każda odpowiedź zawiera Request-Id. Podaj go razem z identyfikatorem źródła i zakresem czasu podczas kontaktu z pomocą techniczną.