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

# Hitelesítés

> Így hitelesítheted magad a Macaly API-ban API-kulcsokkal

<Callout icon="user">
  Csak az [**Ügynökségi csomagban**](/docs/hu/welcome/pricing) érhető el
</Callout>

A Macaly API API-kulcsokkal hitelesít. Az API-kulcsok a munkaterülethez tartoznak, és ugyanazt a kreditrendszert használják, mint a webes felület.

## API-kulcs beszerzése

1. Jelentkezz be a Macaly-fiókodba
2. Kattints a profilodra (jobb felül)
3. Nyisd meg a **Beállítások → API-kulcsok** oldalt
4. Kattints az "Új API-kulcs létrehozása" gombra
5. Másold ki a kulcsot azonnal (csak egyszer jelenik meg)

## Az API-kulcs használata

Add meg az API-kulcsot az `Authorization` fejlécben minden kérésnél:

```
Authorization: Bearer macaly_your_api_key_here
```

### Példa kérés

```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": "Create a landing page"}'
```

## Az API-kulcs formátuma

| Tulajdonság | Érték |
| - | - |
| Előtag | `macaly_` |
| Teljes hossz | 39 karakter |
| Példa | `macaly_abc123def456ghi789jkl012mno345` |

## Biztonsági ajánlások

<Warning>
  Az API-kulcsok teljes hozzáférést adnak a munkaterületed erőforrásaihoz és krediteihez. Kezeld őket jelszóként.
</Warning>

1. **Tárold biztonságosan a kulcsokat** - Használj környezeti változókat, és soha ne tedd őket a kódba
2. **Cseréld rendszeresen a kulcsokat** - Időnként vond vissza a régieket, és hozz létre újakat
3. **Használj külön kulcsokat** - Minden környezethez és alkalmazáshoz hozz létre saját kulcsot
4. **Figyeld a használatot** - Rendszeresen ellenőrizd az egyenlegedet az irányítópulton
5. **Vond vissza a kiszivárgott kulcsokat** - Ha egy kulcs nyilvánosságra került, azonnal vond vissza

## Kérések korlátozása

* A sikertelen API-kulcsos hitelesítési kísérletek IP-címenként percenként 5-re vannak korlátozva
* Ez védelmet nyújt a találgatásos támadások ellen

## Kulcskezelés

Az API-kulcsaidat a Macaly irányítópultján kezelheted:

* **Kulcsok megtekintése** - Az összes aktív kulcs a létrehozás és az utolsó használat idejével
* **Kulcsok létrehozása** - Új kulcsok generálása, szükség esetén azonosítást segítő névvel
* **Kulcsok visszavonása** - A már nem használt vagy kiszivárgott kulcsok letiltása


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