ThunderStream
THUNDERSTREAM · CREATOR STUDIO

API pre vývojárov

Prepojte svoje vlastné automatizácie s čítaním údajov o účte bez následného pripojenia k platformám LIVE.

Stav popisov:

Prvý beh

  1. Krok 1

    Otvorte Integrácie pre vývojárov a skontrolujte aktuálne dostupné rozsahy.

  2. Krok 2

    Vytvorte token iba pre operácie, ktoré potrebujete.

  3. Krok 3

    Použite príklady a formát údajov zobrazené na informačnom paneli. Pri čítaní udalostí držte kurzor.

  4. Krok 4

    Zvládnite prerušenia, opakované pokusy a žiadne nové udalosti. Zrušte token, ktorý už nepotrebujete.

Príklad vysielania

Váš vlastný nástroj načítava následné udalosti bez toho, aby viackrát spracovával rovnakú históriu. Kurzor vám umožňuje pokračovať z poslednej pozície a obmedzené rozsahy tokenu zužujú jeho povolenia.

Akcia a možnosti

Klávesy s rozsahmi

V časti Integrations vytvorte kľúč so samostatnými povoleniami pre stav LIVE, udalosti, časovač alebo hudobný rad. Kľúč ukážeme iba raz. Vyberte si platnosť 7, 30 alebo 90 dní; môžete ho kedykoľvek odvolať.

Čítanie a kurzor

Odovzdajte kľúč v hlavičke Autorizácia: Nositeľ. Čítanie udalostí využíva za kurzor, vďaka čomu automatika neopakuje staré správy. Prvé čítanie bez kurzora začína od aktuálneho okamihu. Čítanie je obmedzené na údaje vlastníka kľúča.

Príklad a dokumentácia

Stiahnite si popis OpenAPI 3.1 a ukážku JavaScriptu na svoj vlastný server, Node-RED alebo iné automatizačné prostredie. Posielajte vždy jednu žiadosť, odporúča sa každé dve sekundy, s limitom 60 žiadostí za minútu. Neumiestňujte kľúč do verejného kódu HTML ani do prekryvnej adresy.

Keď niečo nefunguje

Prístup je zamietnutý

Skontrolujte token a požadovaný rozsah. Používajte aktuálnu dokumentáciu koncového bodu a správnu metódu žiadosti.

Tie isté udalosti sa opakujú

Uložte vrátený kurzor a deduplikované ID. Nezačínajte každé čítanie od začiatku príbehu.

Ukážka rozhrania

Ukážka rozhrania