API-documentatie

Integreer Passly eenvoudig in uw toepassingen met onze REST-API

Basis-URL

Alle verzoeken vertrekken vanaf deze URL. Geen sleutel, geen registratie.

120
Verzoeken / 10 min
Zonder sleutel
Openbare API
v1
API-versie
…
Responstijd
Productiehttps://passly.fr/api/v1

Endpoints

Drie ingangen. Klap er één open voor de parameters, een voorbeeld en het antwoord.

Verzoeklimiet

Een quotum per IP-adres beschermt de dienst. De headers tonen waar u staat.

Limiet per IP

120 verzoeken per 10 minuten

Antwoordheaders

  • X-RateLimit-Limit
  • X-RateLimit-Remaining
  • X-RateLimit-Reset

Fout 429

Wordt teruggegeven wanneer de limiet is bereikt. De header Retry-After geeft de wachttijd aan.

Foutcodes

Elke fout geeft JSON met een vaste vorm terug, met een bruikbare code.

400Bad Request

Ongeldige of ontbrekende parameters

{
    "error": true,
    "message": "Lengte moet tussen 4 en 128 tekens zijn",
    "code": "invalid_length"
}
429Too Many Requests

Verzoeklimiet overschreden

{
    "error": true,
    "message": "Limiet bereikt. Wacht 234 seconden",
    "retry_after": 234,
    "reset_at": "2026-01-15T10:35:00.000Z"
}
500Internal Server Error

Interne serverfout

{
    "error": true,
    "message": "Er is een fout opgetreden. Probeer het opnieuw."
}
503Service Unavailable

Dienst in onderhoud

{
    "error": true,
    "message": "De site is momenteel in onderhoud. Probeer het over enkele minuten opnieuw."
}

Codes die in het veld code worden teruggegeven

  • invalid_length
  • invalid_count
  • invalid_format
  • invalid_words
  • no_charset
  • empty_wordlist

Integratievoorbeelden

Dezelfde aanroep, in de taal van uw keuze. Kopiëren, plakken, aanpassen.

// PasslyClient.js
class PasslyClient {
    constructor(baseURL = 'https://passly.fr/api/v1') {
        this.baseURL = baseURL;
    }

    async generatePassword(options = {}) {
        const response = await fetch(`${this.baseURL}/generate`, {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({
                length: options.length || 16,
                count: options.count || 1,
                lowercase: options.lowercase !== false,
                uppercase: options.uppercase !== false,
                digits: options.digits !== false,
                special: options.special || false,
                exclude_similar: options.excludeSimilar || false,
                format: options.format || 'random'
            })
        });

        if (!response.ok) {
            throw new Error(`API Error: ${response.status}`);
        }

        return response.json();
    }

    async checkHealth() {
        const response = await fetch(`${this.baseURL}/health`);
        return response.json();
    }
}

// Utilisation
const passly = new PasslyClient();

const result = await passly.generatePassword({
    length: 24,
    special: true,
    excludeSimilar: true
});

console.log('Mot de passe:', result.data.passwords[0]);
console.log('Force:', result.data.strength);
console.log('Entropie:', result.data.entropy_bits, 'bits');