Authentification

​

Obtenir une clé API

1. Connectez-vous à votre compte Macaly
2. Cliquez sur votre profil (en haut à droite)
3. Allez dans Paramètres → Clés API
4. Cliquez sur « Créer une nouvelle clé API »
5. Copiez la clé immédiatement (elle ne sera affichée qu’une seule fois)

​

Utiliser la clé API

Authorization: Bearer macaly_your_api_key_here

​

Exemple de requête

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

​

Format de la clé API

​

Bonnes pratiques de sécurité

1. Stockez les clés de manière sécurisée - Utilisez des variables d’environnement, ne les commitez jamais dans le code
2. Renouvelez les clés régulièrement - Révoquez et recréez les clés périodiquement
3. Utilisez des clés distinctes - Créez des clés différentes pour chaque environnement ou application
4. Surveillez l’utilisation - Vérifiez régulièrement votre solde via le dashboard
5. Révoquez les clés compromises - Si une clé est exposée, révoquez-la immédiatement

​

Limites de requêtes

• Les tentatives échouées de clé API sont limitées à 5 par minute par IP
• Cela protège contre les attaques par force brute

​

Gestion des clés

• Voir les clés - Consultez toutes les clés actives avec leur date de création et leur dernière utilisation
• Créer des clés - Générez de nouvelles clés avec des noms optionnels pour les identifier
• Révoquer des clés - Désactivez les clés qui ne sont plus nécessaires ou qui ont été compromises