Skip to main content
Finns bara i abonnemanget Byrå
Macaly API använder API-nycklar för autentisering. Nycklarna är knutna till ett team och använder samma kreditsystem som webbgränssnittet.

Skaffa en API-nyckel

  1. Logga in på ditt Macaly-konto
  2. Klicka på din profil (uppe till höger)
  3. Gå till Inställningar → API-nycklar
  4. Klicka på “Skapa ny API-nyckel”
  5. Kopiera nyckeln direkt (den visas bara en gång)

Använda API-nyckeln

Skicka med API-nyckeln i headern Authorization i alla anrop:

Exempelanrop

Format på API-nyckeln

Säkerhetsrekommendationer

API-nycklar ger full åtkomst till ditt teams resurser och krediter. Behandla dem som lösenord.
  1. Förvara nycklarna säkert - Använd miljövariabler och checka aldrig in dem i koden
  2. Byt nycklar regelbundet - Återkalla och skapa nya nycklar med jämna mellanrum
  3. Använd separata nycklar - Skapa olika nycklar för olika miljöer och applikationer
  4. Följ användningen - Kontrollera ditt saldo regelbundet i instrumentpanelen
  5. Återkalla komprometterade nycklar - Om en nyckel har exponerats ska du återkalla den direkt

Begränsningar för antal anrop

  • Misslyckade försök med API-nyckel är begränsade till 5 per minut och IP-adress
  • Det skyddar mot brute force-attacker

Hantera nycklar

Du hanterar dina API-nycklar i Macalys instrumentpanel:
  • Visa nycklar - Se alla aktiva nycklar med skapandedatum och senaste användning
  • Skapa nycklar - Generera nya nycklar, med valfritt namn så att de är lätta att känna igen
  • Återkalla nycklar - Inaktivera nycklar som inte längre behövs eller som har komprometterats