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

# Authentification

> Apprenez à vous authentifier avec l'API Macaly à l'aide de clés API

<Callout icon="user">
  Disponible uniquement avec le [**forfait Agences**](/docs/fr/welcome/pricing)
</Callout>

L'API Macaly utilise des clés API pour l'authentification. Les clés API sont liées à l'équipe et partagent le même système de crédits que l'interface web.

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

Incluez la clé API dans l'en-tête `Authorization` pour toutes les requêtes :

```
Authorization: Bearer macaly_your_api_key_here
```

### Exemple de requête

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

## Format de la clé API

| Propriété | Valeur |
| - | - |
| Préfixe | `macaly_` |
| Longueur totale | 39 caractères |
| Exemple | `macaly_abc123def456ghi789jkl012mno345` |

## Bonnes pratiques de sécurité

<Warning>
  Les clés API donnent un accès complet aux ressources et crédits de votre équipe. Traitez-les comme des mots de passe.
</Warning>

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

Vous pouvez gérer vos clés API dans le dashboard Macaly :

* **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


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