# Authentification

Chaque requête à l’API REST transporte votre clé dans un en-tête. Une clé par compte, disponible après la première recharge et révocable à tout moment depuis le tableau de bord.

## Comment s’authentifier sur l’API SMS Nitro ?

Envoyez la clé dans l’en-tête X-Api-Key (Authorization: Bearer <clé> fonctionne aussi) à chaque requête vers https://smsnitro.com/api/v1. Une clé absente, erronée ou révoquée renvoie 401 avec le détail Invalid or revoked API key.

## Générer la clé

- L’accès à l’API s’ouvre après la première recharge confirmée.
- Ouvrez Tableau de bord > API et générez la clé. Elle ne s’affiche qu’une fois : enregistrez-la tout de suite dans un coffre de secrets.
- Chaque compte a une clé active. En générer une nouvelle révoque immédiatement la précédente.

## Envoyer la clé

Les deux formats d’en-tête sont acceptés sur tous les endpoints. Choisissez-en un et gardez-le partout.

| En-tête | Exemple |
|---|---|
| X-Api-Key | X-Api-Key: <votre clé> (recommandé) |
| Authorization | Authorization: Bearer <votre clé> |

**X-Api-Key**

```bash
curl https://smsnitro.com/api/v1/balance \
  -H "X-Api-Key: $SMSNITRO_API_KEY"
```

**Bearer**

```bash
curl https://smsnitro.com/api/v1/balance \
  -H "Authorization: Bearer $SMSNITRO_API_KEY"
```

## Protéger la clé

La clé peut dépenser votre solde : traitez-la comme un mot de passe.

- Gardez-la dans une variable d’environnement ou un gestionnaire de secrets, jamais dans le code source.
- Appelez l’API uniquement depuis votre serveur. Ne la placez jamais dans un navigateur, une application mobile ou un logiciel de bureau.
- Ne la collez pas dans des tickets, des journaux ou des captures d’écran.
- En cas de fuite, générez-en une nouvelle depuis le tableau de bord : l’ancienne cesse aussitôt de fonctionner.

**Variable d’environnement**

```bash
# .env (never commit this file)
SMSNITRO_API_KEY=your-key-from-the-dashboard
```

## FAQ

**Puis-je avoir plusieurs clés ?** Non. Chaque compte a une clé active ; en générer une autre remplace l’actuelle.

**La clé expire-t-elle ?** Non. Elle reste valable jusqu’à ce que vous en génériez une nouvelle depuis le tableau de bord.

Source: https://smsnitro.com/fr/developpeurs/authentification