Tunnistautuminen

​

API-avaimen hankkiminen

1. Kirjaudu Macaly-tilillesi
2. Napsauta profiiliasi (oikealla ylhäällä)
3. Siirry kohtaan Asetukset → API-avaimet
4. Napsauta “Luo uusi API-avain”
5. Kopioi avain heti (se näytetään vain kerran)

​

API-avaimen käyttö

Authorization: Bearer macaly_your_api_key_here

​

Esimerkkipyyntö

curl -X POST https://www.macaly.com/api/chat \
  -H "Authorization: Bearer macaly_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "Luo laskeutumissivu"}'

​

API-avaimen muoto

​

Tietoturvan hyvät käytännöt

1. Säilytä avaimet turvallisesti: käytä ympäristömuuttujia äläkä koskaan tallenna avaimia koodiin
2. Vaihda avaimet säännöllisesti: poista avaimia käytöstä ja luo uusia aika ajoin
3. Käytä erillisiä avaimia: luo eri ympäristöille ja sovelluksille omat avaimensa
4. Seuraa käyttöä: tarkista saldosi säännöllisesti hallintapaneelista
5. Poista vaarantuneet avaimet käytöstä: jos avain paljastuu, poista se käytöstä heti

​

Käyttörajat

• Epäonnistuneita API-avaimen tunnistautumisyrityksiä rajoitetaan 5 minuutissa IP-osoitetta kohti
• Tämä suojaa raa’an voiman hyökkäyksiltä

​

Avainten hallinta

• Avainten tarkastelu: näet kaikki aktiiviset avaimet sekä niiden luontipäivän ja viimeisen käyttöajan
• Avainten luominen: luo uusia avaimia ja anna niille halutessasi tunnistamista helpottava nimi
• Avainten käytöstä poisto: poista käytöstä avaimet, joita et enää tarvitse tai jotka ovat vaarantuneet