> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tunnistautuminen

> Opi tunnistautumaan Macalyn API:ssa API-avaimilla

<Callout icon="user">
  Käytettävissä vain [**Toimisto-paketissa**](/docs/fi/welcome/pricing)
</Callout>

Macalyn API käyttää tunnistautumiseen API-avaimia. Avaimet kuuluvat workspaceen, ja ne käyttävät samaa krediittijärjestelmää kuin verkkokäyttöliittymä.

## 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ö

Lisää API-avain `Authorization`-otsakkeeseen jokaisessa pyynnössä:

```
Authorization: Bearer macaly_your_api_key_here
```

### Esimerkkipyyntö

```bash theme={null}
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

| Ominaisuus | Arvo |
| - | - |
| Etuliite | `macaly_` |
| Kokonaispituus | 39 merkkiä |
| Esimerkki | `macaly_abc123def456ghi789jkl012mno345` |

## Tietoturvan hyvät käytännöt

<Warning>
  API-avaimet antavat täyden pääsyn workspacesi resursseihin ja krediitteihin. Kohtele niitä kuin salasanoja.
</Warning>

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

Voit hallita API-avaimiasi Macalyn hallintapaneelissa:

* **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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.