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

# Autenticazione

> Scopri come autenticarti con l'API di Macaly usando le chiavi API

<Callout icon="user">
  Disponibile solo con il [**piano Agenzie**](/docs/it/welcome/pricing)
</Callout>

L'API di Macaly usa chiavi API per l'autenticazione. Le chiavi API sono legate al team e condividono lo stesso sistema di crediti dell'interfaccia web.

## Ottenere una chiave API

1. Accedi al tuo account Macaly
2. Fai clic sul tuo profilo (in alto a destra)
3. Vai a **Impostazioni → Chiavi API**
4. Fai clic su "Crea una nuova chiave API"
5. Copia subito la chiave (verrà mostrata una sola volta)

## Utilizzare la chiave API

Includi la chiave API nell'header `Authorization` in tutte le richieste:

```
Authorization: Bearer macaly_your_api_key_here
```

### Esempio di richiesta

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

## Formato della chiave API

| Proprietà | Valore |
| - | - |
| Prefisso | `macaly_` |
| Lunghezza totale | 39 caratteri |
| Esempio | `macaly_abc123def456ghi789jkl012mno345` |

## Buone pratiche di sicurezza

<Warning>
  Le chiavi API danno accesso completo alle risorse e ai crediti del tuo team. Trattale come password.
</Warning>

1. **Conserva le chiavi in modo sicuro** - Usa variabili d'ambiente, non inserirle mai nel codice
2. **Rinnova le chiavi regolarmente** - Revoca e ricrea le chiavi periodicamente
3. **Usa chiavi separate** - Crea chiavi diverse per ambienti e applicazioni diversi
4. **Monitora l'utilizzo** - Controlla regolarmente il tuo saldo dal dashboard
5. **Revoca le chiavi compromesse** - Se una chiave viene esposta, revocala immediatamente

## Limiti di richieste

* I tentativi falliti con la chiave API sono limitati a 5 al minuto per indirizzo IP
* Questo protegge dagli attacchi brute-force

## Gestione delle chiavi

Puoi gestire le tue chiavi API dal dashboard di Macaly:

* **Visualizza le chiavi** - Consulta tutte le chiavi attive con la data di creazione e l'ultimo utilizzo
* **Crea chiavi** - Genera nuove chiavi con un nome facoltativo per identificarle
* **Revoca chiavi** - Disattiva le chiavi non più necessarie o compromesse


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