Opprett og tilbakekall API-tokener

Hva et token kan gjøre

Et token handler på vegne av personen som opprettet det, i teamet som var aktivt da. Det kan bare gjøre det du tillater når du oppretter det. Du velger ett av disse:

• Styr skjermer og scener: se skjermer, innhold og scener, vise innhold på en skjerm, og starte og stoppe scener. Bruk dette for Bitfocus Companion.
• Kun lesetilgang: se skjermer, innhold og scener, ingenting annet.
• Full tilgang, også til å opprette design: alt over, og å opprette design.

Hvis personen som opprettet tokenet mister tilgangen til teamet, slutter tokenet å virke.

Opprett et token

1. Gå til Innstillinger > Tilkoblinger.
2. Klikk på Nytt API-token under API-tokener.
3. Gi tokenet et navn, for eksempel navnet på stedet eller på programmet som bruker det.
4. Velg under Tilgang hva tokenet skal få lov til.
5. Klikk på Opprett token.
6. Klikk på Kopier og oppbevar tokenet på et trygt sted, for eksempel i programmet som trenger det.
7. Klikk på Ferdig.

Du ser tokenet bare én gang. Hvis du mister det, tilbakekaller du det og oppretter et nytt.

Tokenet virker i teamet som er aktivt når du oppretter det. Skal du nå skjermene i et annet team, bytter du først til det teamet og oppretter et eget token. Bruk ett token per program, så du kan tilbakekalle ett uten å stoppe de andre.

Som standard kan eieren og administratorene opprette tokener. Det avhenger av rollen din. Du endrer dette per rolle i Administrer team.

E-post når et token opprettes

Når noen oppretter et token, får vedkommende og eierne av kontoen en e-post. E-posten sier hvilket token det gjelder, hvem som opprettet det, for hvilket team, når, og hva det kan gjøre. E-posten inneholder aldri selve tokenet. Hvis du ikke ventet noe token, tilbakekaller du det med en gang.

Se tokenene dine

Kortet API-tokener viser for hvert token:

• navnet og typen tilgang;
• de fire siste tegnene i tokenet, så du kan skille tokenene fra hverandre;
• teamet;
• når det sist ble brukt, eller Aldri brukt.

Eieren ser tokenene til alle i kontoen. Alle andre ser sine egne.

Tilbakekall et token

1. Gå til Innstillinger > Tilkoblinger.
2. Klikk på Tilbakekall ved siden av tokenet.
3. Bekreft med Tilbakekall.

Alt som bruker tokenet, slutter å virke med en gang.

Tokener som utløper

Et token som ikke er brukt på ett år, blir tilbakekalt automatisk. Et token som aldri er brukt, regnes fra dagen det ble opprettet. Opprett et nytt token hvis du trenger ett igjen.

Grense

En konto kan ha et begrenset antall tokener. Når du har nådd grensen, ber Screenbird deg tilbakekalle ett først.

Tilkoblede apper

Apper som du kobler til med en Screenbird-innlogging i stedet for et token, vises i et eget kort, Tilkoblede apper, på samme side. Klikk på Koble fra for å fjerne en.

Bygg din egen tilkobling

Screenbird har et åpent API. Send tokenet ditt som bearer-token med hver forespørsel. Den fullstendige beskrivelsen av API-et, med alle forespørslene og rettighetene hver av dem krever, finner du på api.screenbird.app/v1/openapi.json.