Skapa och återkalla API-tokens
Vad en token kan göra
En token agerar för personen som skapade den, i det team som var aktivt då. Den kan bara göra det du tillåter när du skapar den. Du väljer något av följande:
- Styr skärmar och scener: se skärmar, innehåll och scener, visa innehåll på en skärm samt starta och stoppa scener. Använd den här för Bitfocus Companion.
- Endast läsåtkomst: se skärmar, innehåll och scener, inget annat.
- Full åtkomst, även att skapa designer: allt ovan, och att skapa designer.
Om personen som skapade tokenen förlorar åtkomsten till teamet slutar tokenen att fungera.
Skapa en token
- Gå till Inställningar > Anslutningar.
- Klicka på Ny API-token under API-tokens.
- Ge tokenen ett namn, till exempel namnet på lokalen eller på programmet som använder den.
- Välj under Åtkomst vad tokenen får göra.
- Klicka på Skapa token.
- Klicka på Kopiera och spara tokenen på ett säkert ställe, till exempel i programmet som behöver den.
- Klicka på Klar.
Du ser tokenen bara en gång. Om du tappar bort den återkallar du den och skapar en ny.
Tokenen fungerar i det team som är aktivt när du skapar den. Vill du nå skärmarna i ett annat team byter du först till det teamet och skapar en separat token. Använd en egen token för varje program, så att du kan återkalla en utan att stoppa de andra.
Som standard kan ägaren och administratörerna skapa tokens. Det styrs av din roll. Du ändrar det per roll i Hantera team.
Mejl när en token skapas
När någon skapar en token får personen själv och kontots ägare ett mejl. Mejlet anger vilken token det gäller, vem som skapade den, för vilket team, när och vad den får göra. Mejlet innehåller aldrig själva tokenen. Om du inte väntade dig någon token återkallar du den direkt.
Se dina tokens
Kortet API-tokens visar för varje token:
- namnet och typen av åtkomst;
- de fyra sista tecknen i tokenen, så att du kan skilja tokens åt;
- teamet;
- när den användes senast, eller Aldrig använd.
Ägaren ser tokens för alla i kontot. Alla andra ser sina egna.
Återkalla en token
- Gå till Inställningar > Anslutningar.
- Klicka på Återkalla bredvid tokenen.
- Bekräfta med Återkalla.
Allt som använder tokenen slutar fungera direkt.
Tokens som går ut
En token som inte har använts på ett år återkallas automatiskt. En token som aldrig har använts räknas från dagen den skapades. Skapa en ny token om du behöver en igen.
Gräns
Ett konto kan ha ett begränsat antal tokens. När du har nått gränsen ber Screenbird dig att först återkalla en.
Anslutna appar
Appar som du ansluter med en Screenbird-inloggning i stället för en token visas på samma sida, i ett eget kort, Anslutna appar. Klicka på Koppla från för att ta bort en.
Bygg din egen anslutning
Screenbird har ett öppet API. Skicka din token som bearer-token med varje förfrågan. Den fullständiga beskrivningen av API:t, med alla förfrågningar och de rättigheter var och en kräver, finns på api.screenbird.app/v1/openapi.json.