Authentification

Gestion des clés API et des scopes d'accès

Clés API

Les clés API sont utilisées pour authentifier vos requêtes. Elles commencent par jm_live_ pour la production ou jm_test_ pour les tests.

Créer une clé API

1. Connectez-vous à JunkMail (plan Business requis)
2. Allez dans "Clés API"
3. Cliquez sur "Créer une clé"
4. Donnez un nom à votre clé
5. Sélectionnez les scopes nécessaires
6. Copiez la clé (affichée une seule fois)

Scopes disponibles

Scope	Description
emails:read	Lire les adresses et emails
emails:write	Créer/supprimer des adresses et emails
analytics:read	Accéder aux statistiques
domains:read	Lire les domaines
domains:manage	Gérer les domaines
webhooks:manage	Gérer les webhooks

Utilisation

Incluez votre clé API dans le header Authorization :

curl -X GET https://api.junkmail.dev/api/v1/addresses \
  -H "Authorization: Bearer jm_live_xxxxxxxxxxxx"

JavaScript

const response = await fetch('https://api.junkmail.dev/api/v1/addresses', {
  headers: {
    'Authorization': 'Bearer jm_live_xxxxxxxxxxxx',
    'Content-Type': 'application/json',
  },
});

Python

import requests

response = requests.get(
    'https://api.junkmail.dev/api/v1/addresses',
    headers={
        'Authorization': 'Bearer jm_live_xxxxxxxxxxxx',
        'Content-Type': 'application/json',
    }
)

Révoquer une clé

Pour des raisons de sécurité, vous pouvez révoquer une clé API :

1. Allez dans "Clés API"
2. Trouvez la clé à révoquer
3. Cliquez sur "Révoquer"
4. Confirmez la révocation

Important : Une fois révoquée, la clé ne peut plus être utilisée et ne peut pas être récupérée.

Bonnes pratiques

• Ne partagez jamais vos clés API
• Utilisez des variables d'environnement
• Créez des clés séparées par environnement (dev, prod)
• Utilisez les scopes minimums nécessaires
• Révoquz les clés inutilisées