Importowanie danych Samsara

Użyj połączenia Generic REST i kroku Żądanie REST do importu danych Samsara. Dzięki temu token API jest przechowywany w wielokrotnie używanym połączeniu, a stosowane są te same ogólne mechanizmy stronicowania kursorem, które są dostępne dla każdego interfejsu API zwracającego kursor kontynuacji.

Zanim zaczniesz

W Samsara utwórz token API tylko z zakresami odczytu i dostępem do tagów potrzebnymi do importu. Samsara pokazuje token wyłącznie w chwili jego utworzenia, więc skopiuj go przed opuszczeniem strony. Zobacz uwierzytelnianie w API Samsara.

Wybierz host odpowiadający Twojemu pulpitowi Samsara:

Pulpit Samsara	Host lub adres IP
Chmura US lub starsza chmura Canada	`api.samsara.com`
EU / UK	`api.eu.samsara.com`
Chmura Canada	`api.ca.samsara.com`

Tworzenie połączenia

Otwórz Connections i utwórz połączenie Generic REST o nazwie Samsara.
Wprowadź odpowiedni host z powyższej tabeli.
W sekcji Uwierzytelnianie wybierz Token okaziciela i wklej token API Samsara. Nie dodawaj samodzielnie nagłówka Authorization.
Zapisz połączenie.

Importowanie pojazdów

Ten pierwszy import potwierdza połączenie i dostarcza recepturę, którą można ponownie wykorzystać dla innych nowoczesnych punktów końcowych list Samsara.

Dodaj krok Żądanie REST i wybierz połączenie Samsara.
Ustaw Źródło punktów końcowych na Ręcznie, Metoda na GET, a Punkt końcowy na /fleet/vehicles.
Wybierz Tabela docelowa, na przykład samsara_vehicles.
W sekcji Parametry zapytania dodaj limit o wartości 512.
W sekcji Żądanie ustaw następujące wartości:

Pole	Wartość
Format wiersza	`Object`
Tryb strumieniowania	`Cursor Paging`
Ścieżka elementów (Formatowanie JSON)	`["data"]`
Mode Params (Formatowanie JSON)	`{"cursor": "after"}`
Mode Paths (Formatowanie JSON)	`{"has_more": ["pagination", "hasNextPage"], "cursor": ["pagination", "endCursor"]}`

Wybierz Testuj stronicowanie. PlaidCloud pobiera tylko tyle stron, ile potrzeba do podglądu, więc możesz zweryfikować wynik przed pełnym uruchomieniem.
Zapisz i uruchom krok.

Skopiuj te wartości dokładnie podczas konfigurowania nowoczesnego punktu końcowego listy Samsara:

{"cursor": "after"}

{"has_more": ["pagination", "hasNextPage"], "cursor": ["pagination", "endCursor"]}

Gdy Samsara zwraca hasNextPage: true, PlaidCloud wysyła zwrócony endCursor jako parametr after następnego żądania. Kontynuuje nawet wtedy, gdy strona jest pusta, ponieważ Samsara może mieć dalsze strony z danymi. Zobacz stronicowanie w Samsara.

Efektywne uruchamianie

Używaj jednego kroku Żądanie REST dla każdego punktu końcowego listy. Wartości kursora są nieprzejrzyste i muszą być wysyłane dokładnie tak, jak zostały zwrócone.
Ustaw limit=512, gdy punkt końcowy obsługuje limit; 512 to udokumentowane maksimum Samsara.
Unikaj rozgałęzienia „jedno żądanie na wiersz” dla punktu końcowego listy. Stosuj je tylko do naprawdę niezależnych żądań szczegółów i utrzymuj częstotliwość żądań w granicach limitu punktu końcowego.
Punkty końcowe /feed są przyrostowe, a nie pełnymi migawkami. Zachowuj ostatni udany kursor i uruchamiaj przepływ pracy według harmonogramu częściej niż wynosi 30-dniowy okres wygasania kursora w Samsara.

Rozwiązywanie problemów

Problem	Co sprawdzić
`401` lub `403`	Sprawdź regionalny host, token, dostęp do tagów i zakres odczytu punktu końcowego.
Brak wierszy	Upewnij się, że to punkt końcowy listy, a Ścieżka elementów to `["data"]`.
Stronicowanie kończy się zbyt wcześnie	Użyj nowoczesnego punktu końcowego z aktualnej dokumentacji API Samsara. Starsze punkty końcowe `/v1/` mogą używać innych pól stronicowania.
`429`	Zmniejsz częstotliwość żądań dla niezależnych wywołań rozgałęzionych. Krok Żądanie REST respektuje odpowiedź `Retry-After` Samsara, gdy ponawia bezpieczne żądanie odczytu.