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

# Autentizace

> Jak se autentizovat pomocí API klíčů v Macaly API

<Note>
  API je dostupné výhradně v rámci plánu Enterprise. [Kontaktujte nás](mailto:support@macaly.com) pro více informací o cenách a funkcích pro firmy.
</Note>

Macaly API používá k autentizaci API klíče. Klíče jsou vázané na tým a sdílejí stejný systém kreditů jako webové rozhraní.

## Získání API klíče

1. Přihlaste se ke svému účtu Macaly
2. Klikněte na svůj profil (vpravo nahoře)
3. Přejděte do **Nastavení → API klíče**
4. Klikněte na „Vytvořit nový API klíč"
5. Klíč si ihned zkopírujte (zobrazí se pouze jednou)

## Použití API klíče

API klíč uveďte v hlavičce Authorization u všech požadavků:

```
Authorization: Bearer macaly_your_api_key_here
```

### Příklad požadavku

```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"}'
```

## Formát API klíče

| Vlastnost     | Hodnota                                 |
| ------------- | --------------------------------------- |
| Prefix        | `macaly_`                               |
| Celková délka | 39 znaků                                |
| Příklad       | `macaly_abc123def456ghi789jkl012mno345` |

## Bezpečnostní doporučení

<Warning>
  API klíče poskytují plný přístup ke zdrojům a kreditům vašeho týmu. Zacházejte s nimi jako s hesly.
</Warning>

1. **Uchovávejte klíče bezpečně** – Používejte proměnné prostředí, nikdy je neukládejte přímo do kódu
2. **Klíče pravidelně obměňujte** – Pravidelně je rušte a vytvářejte nové
3. **Používejte samostatné klíče** – Pro různá prostředí a aplikace vytvářejte samostatné klíče
4. **Sledujte využití** – Pravidelně kontrolujte využití kreditů v nastavení
5. **Kompromitované klíče ihned zrušte** – Pokud dojde k prozrazení klíče, zneplatněte ho co nejdříve

## Limity požadavků

* Neúspěšné pokusy o autentizaci API klíčem jsou omezeny na 5 požadavků za minutu na IP adresu
* Toto opatření chrání proti útokům hrubou silou

## Správa klíčů

API klíče můžete spravovat v nastavení svého účtu Macaly:

* **Zobrazení klíčů** – Přehled všech aktivních klíčů s datem vytvoření a posledního použití
* **Vytvoření klíčů** – Generování nových klíčů s volitelným názvem pro snadnou identifikaci
* **Odvolání klíčů** – Deaktivace klíčů, které již nepotřebujete nebo které byly kompromitovány