Autenticazione

​

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

Authorization: Bearer macaly_your_api_key_here

​

Esempio di richiesta

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

​

Buone pratiche di sicurezza

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

• 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