Pierwsze uruchomienie
- Krok 1
Otwórz Integracje dla developerów i zapoznaj się z aktualnie dostępnymi zakresami.
- Krok 2
Utwórz token wyłącznie dla potrzebnych operacji.
- Krok 3
Skorzystaj z przykładów i formatu danych pokazywanego w panelu. Przy odczycie zdarzeń zachowuj kursor.
- Krok 4
Obsługuj przerwy, ponawianie i brak nowych zdarzeń. Unieważnij token, którego już nie potrzebujesz.
Przykład na transmisji
Własne narzędzie pobiera kolejne zdarzenia bez wielokrotnego przetwarzania tej samej historii. Kursor pozwala kontynuować od ostatniej pozycji, a ograniczone zakresy tokena zawężają jego uprawnienia.
Działanie i możliwości
Klucze z zakresami
W Integracjach utwórz klucz z osobnymi uprawnieniami do stanu LIVE, zdarzeń, timera lub kolejki muzycznej. Klucz pokazujemy tylko raz. Wybierz ważność 7, 30 lub 90 dni; w dowolnej chwili możesz go unieważnić.
Odczyt i kursor
Przekazuj klucz w nagłówku Authorization: Bearer. Odczyt zdarzeń używa kursora after, dzięki czemu automatyzacja nie powtarza starych wiadomości. Pierwszy odczyt bez kursora zaczyna od bieżącej chwili. Odczyt jest ograniczony do danych właściciela klucza.
Przykład i dokumentacja
Pobierz opis OpenAPI 3.1 oraz przykład JavaScript do własnego serwera, Node-RED lub innego środowiska automatyzacji. Wysyłaj jedno żądanie naraz, zalecane co dwie sekundy, z limitem 60 żądań na minutę. Klucza nie umieszczaj w publicznym HTML ani w adresie overlaya.
Zobacz interfejs z bliska
Kliknij ilustrację, aby ją powiększyć. Zrzuty pokazują różne części konfiguracji; podpis wyjaśnia, na co zwrócić uwagę.
Gdy coś nie działa
Żądanie nie ma dostępu
Sprawdź token i wymagany zakres. Używaj aktualnej dokumentacji endpointu oraz właściwej metody żądania.
Te same zdarzenia powtarzają się
Przechowuj zwrócony kursor i deduplikuj identyfikatory. Nie rozpoczynaj każdego odczytu od początku historii.