Documentation de l'API

Vue d'ensemble

Le service de génération de mots de passe fournit une solution flexible pour créer des mots de passe sécurisés ou des passphrases mémorables. Il offre de nombreuses options de personnalisation et inclut une évaluation de la force du mot de passe généré.

URL de base : https://motdepasse.app/api/generate-password
Méthode : POST
Auth requise : Oui (API Key dans le header)
Format de données : JSON

Authentication

Toutes les requêtes doivent inclure une clé API valide dans les headers.

X-API-KEY: votre-clé-api

Structure de la Requête

{
  "length": number,
  "includeUppercase": boolean,
  "includeLowercase": boolean,
  "includeNumbers": boolean,
  "includeSymbols": boolean,
  "usePassphrase": boolean,
  "wordCount": number,
  "wordSeparator": string
}

Paramètres

Mode Mot de Passe Standard

• length : Longueur du mot de passe

  • Type : number
  • Requis si usePassphrase est false
  • Plage : 4-32 caractères
  • Exemple : 16

• includeUppercase : Inclure des majuscules (A-Z)

  • Type : boolean
  • Défaut : false
  • Exemple : true

• includeLowercase : Inclure des minuscules (a-z)

  • Type : boolean
  • Défaut : true
  • Exemple : true

• includeNumbers : Inclure des chiffres (0-9)

  • Type : boolean
  • Défaut : false
  • Exemple : true

• includeSymbols : Inclure des caractères spéciaux (!@#$%^&*()_+-=[]{}|;:,.<>?)

  • Type : boolean
  • Défaut : false
  • Exemple : true

Mode Passphrase

• usePassphrase : Utiliser le mode passphrase

  • Type : boolean
  • Défaut : false
  • Exemple : true

• wordCount : Nombre de mots dans la passphrase

  • Type : number
  • Requis si usePassphrase est true
  • Plage : 2-10 mots
  • Exemple : 4

• wordSeparator : Séparateur entre les mots

  • Type : string
  • Défaut : "-"
  • Exemple : "_"

Réponses

Succès (200 OK)

Exemple de Réponse pour Mot de Passe Standard

{
  "password": "xK9#mP2$vL5nQ8",
  "strength": "strong"
}

Exemple de Réponse pour Passphrase

{
  "password": "Correct-Horse-Battery-Staple-42!",
  "strength": "veryStrong"
}

Le champ strength peut avoir les valeurs suivantes :

• "weak" : Force faible
• "medium" : Force moyenne
• "strong" : Force élevée
• "veryStrong" : Force très élevée

Erreurs

400 Bad Request

{
  "error": "Invalid length (4-64)"
}

{
  "error": "Invalid word count (2-10)"
}

401 Unauthorized

{
  "error": "Invalid or missing API key"
}

405 Method Not Allowed

{
  "error": "Method Not Allowed"
}

Calcul de la Force du Mot de Passe

Pour les Mots de Passe Standards

La force est calculée selon les critères suivants :

1. Faible (weak) si :

   • Longueur < 8 caractères OU
   • Un seul type de caractères utilisé

2. Moyenne (medium) si :

   • Longueur 8-11 caractères ET
   • Au moins 2 types de caractères ET
   • Inclut des chiffres ou symboles

3. Forte (strong) si :

   • Longueur 12-15 caractères ET
   • Au moins 3 types de caractères ET
   • Inclut des chiffres ou symboles

4. Très Forte (veryStrong) si :

   • Longueur ≥ 16 caractères ET
   • Tous les types de caractères ET
   • Inclut des chiffres et symboles

Pour les Passphrases

La force est calculée selon les critères suivants :

1. Faible (weak) si :

   • Moins de 3 mots

2. Moyenne (medium) si :

   • 3 mots sans extras

3. Forte (strong) si :

   • 4 mots sans extras OU
   • 3 mots avec chiffres ou symboles

4. Très Forte (veryStrong) si :

   • 4+ mots avec chiffres ou symboles

Exemples d'Utilisation

Exemple 1 : Génération d'un Mot de Passe Fort

const request = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'votre-clé-api'
  },
  body: JSON.stringify({
    length: 16,
    includeUppercase: true,
    includeLowercase: true,
    includeNumbers: true,
    includeSymbols: true
  })
};

fetch('https://motdepasse.app/api/generate-password', request)
  .then(response => response.json())
  .then(data => console.log(data));

Exemple 2 : Génération d'une Passphrase

const request = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'votre-clé-api'
  },
  body: JSON.stringify({
    usePassphrase: true,
    wordCount: 4,
    wordSeparator: "-",
    includeNumbers: true,
    includeSymbols: true
  })
};

fetch('https://motdepasse.app/api/generate-password', request)
  .then(response => response.json())
  .then(data => console.log(data));

Recommandations de Sécurité

1. Choix du Mode

   • Passphrase pour une meilleure mémorisation
   • Mot de passe standard pour les contraintes système spécifiques

2. Longueur Recommandée

   • Mots de passe : minimum 12 caractères
   • Passphrases : minimum 4 mots

3. Composition

   • Utiliser tous les types de caractères disponibles
   • Éviter les motifs prévisibles
   • Inclure des chiffres et symboles quand possible

Limites et Considérations

• Longueur maximale de 64 caractères pour les mots de passe standards
• Maximum 10 mots pour les passphrases
• Liste de mots prédéfinie pour les passphrases
• Maximum 100 requêtes par minute par API key
• Les mots de passe générés ne sont pas stockés

Bonnes Pratiques

1. Sécurité

   • Ne transmettez jamais les mots de passe en clair
   • Utilisez HTTPS pour toutes les communications
   • Ne stockez pas les mots de passe générés en clair

2. Usage

   • Générez un nouveau mot de passe pour chaque compte
   • Utilisez le mode approprié selon le contexte
   • Vérifiez la compatibilité avec le système cible

3. Performance

   • Groupez les requêtes quand possible
   • Mettez en cache les résultats temporairement si nécessaire
   • Prévoyez un fallback en cas d'indisponibilité

Support

• Email: support@motdepasse.app
• API Status: https://motdepasse.app/status