API-nyckel
En API-nyckel är en hemlig sträng som bevisar att ett annat system har behörighet att läsa dina data. Den fungerar som ett lösenord, med skillnaden att ett program anger den i stället för en person, och den gäller tills du återkallar den.
Bra att veta: Gatherino-redigeraren och kontot finns på engelska eller tjeckiska. Formulären som dina respondenter fyller i kan visas på 18 språk, inklusive svenska.
Nyckeln skapas i inställningarna och visas exakt en gång. Spara den direkt i en miljövariabel eller en hemlighetshanterare på din server. Du kan inte läsa den i efterhand, eftersom den lagras på ett sätt som gör att det ursprungliga värdet inte kan återskapas.
Det vanligaste misstaget är att lägga nyckeln i sidans JavaScript. Källkoden i webbläsaren är offentlig, så vem som helst kan kopiera nyckeln och ladda ner varje svar från alla dina formulär. API-anrop bör därför ske på en server som har nyckeln och bara returnerar det som är avsett att vara offentligt.
Om en nyckel läcker ska du inte utreda om någon har använt den. Återkalla den och skapa en ny. Återkallelsen sker omedelbart och den gamla nyckeln slutar fungera.
I praktiken
- Nyckeln ska ligga i en miljövariabel på servern, inte i ett kodförråd och inte i frontend-koden.
- Använd helst en separat nyckel per integration, så att du kan återkalla just den.
- Byt ut nyckeln när någon som kände till den slutar.
Vanliga frågor
Var skapar jag en API-nyckel?
Under Inställningar → API-nycklar. Den visas bara en gång.
Hur skickas nyckeln?
I en Authorization: Bearer <key>-header eller i en x-api-key-header.
Vad händer när jag återkallar en nyckel?
Den slutar fungera omedelbart, och integrationer som använder den får ett 401-svar.
Relaterat
Prova Gatherino gratis
Gratisplan: 3 formulär och 100 svar per månad. Inget kreditkort krävs och data lagras inom EU.
Kom igång gratis →