Opret og tilbagekald API-tokens

Hvad et token kan

Et token handler på vegne af den person, der oprettede det, i det team, der var aktivt på det tidspunkt. Det kan kun gøre det, du tillader, når du opretter det. Du vælger en af disse:

• Styr skærme og scener: se skærme, indhold og scener, vise indhold på en skærm og starte og stoppe scener. Brug den til Bitfocus Companion.
• Kun læseadgang: se skærme, indhold og scener, og intet andet.
• Fuld adgang, også til at oprette designs: alt ovenstående og oprettelse af designs.

Mister den person, der oprettede tokenet, adgangen til teamet, holder tokenet op med at virke.

Opret et token

1. Gå til Indstillinger > Forbindelser.
2. Klik på Nyt API-token under API-tokens.
3. Giv tokenet et navn, for eksempel navnet på stedet eller på det program, der bruger det.
4. Vælg under Adgang, hvad tokenet må.
5. Klik på Opret token.
6. Klik på Kopiér, og gem tokenet et sikkert sted, for eksempel i det program, der skal bruge det.
7. Klik på Færdig.

Du ser kun tokenet én gang. Hvis du mister det, skal du tilbagekalde det og oprette et nyt.

Tokenet virker i det team, der er aktivt, når du opretter det. Til et andet teams skærme skifter du først til det team og opretter et separat token. Brug et eget token til hvert program, så du kan tilbagekalde ét uden at stoppe de andre.

Som standard kan ejeren og administratorerne oprette tokens. Din rolle afgør det. Det ændrer du pr. rolle i Administrer teams.

Mail, når et token oprettes

Når nogen opretter et token, får vedkommende og kontoens ejere en e-mail. Mailen fortæller, hvilket token det er, hvem der oprettede det, til hvilket team, hvornår og hvad det må. Mailen indeholder aldrig selve tokenet. Hvis du ikke ventede et token, skal du tilbagekalde det med det samme.

Se dine tokens

Kortet API-tokens viser for hvert token:

• navnet og typen af adgang;
• de sidste fire tegn i tokenet, så du kan kende tokens fra hinanden;
• teamet;
• hvornår det sidst blev brugt, eller Aldrig brugt.

Ejeren ser alles tokens i kontoen. Alle andre ser kun deres egne.

Tilbagekald et token

1. Gå til Indstillinger > Forbindelser.
2. Klik på Tilbagekald ved siden af tokenet.
3. Bekræft med Tilbagekald.

Alt, der bruger tokenet, stopper med det samme.

Tokens, der udløber

Et token, der ikke er brugt i et år, bliver tilbagekaldt af sig selv. Et token, der aldrig er brugt, regnes fra den dag, det blev oprettet. Opret et nyt token, hvis du får brug for et igen.

Grænse

En konto kan have et begrænset antal tokens. Når du når grænsen, beder Screenbird dig om først at tilbagekalde et.

Forbundne apps

Apps, som du forbinder med et Screenbird-login i stedet for et token, vises på samme side i deres eget kort Forbundne apps. Klik på Afbryd for at fjerne en.

Byg din egen forbindelse

Screenbird har et offentligt API. Send dit token som bearer-token med hver forespørgsel. Den fulde beskrivelse af API'et, med alle forespørgsler og de rettigheder, hver enkelt kræver, findes på api.screenbird.app/v1/openapi.json.