Documentazione API

Integra facilmente Passly nelle tue applicazioni con la nostra API REST

URL di base

Tutte le richieste partono da questo URL. Nessuna chiave, nessuna registrazione.

120

Richieste / 10 min

Senza chiave

API pubblica

Versione API

…

Tempo di risposta

Produzionehttps://passly.fr/api/v1

Endpoint

Tre punti di ingresso. Espandine uno per vederne parametri, esempio e risposta.

Limitazione delle richieste

Una quota per indirizzo IP protegge il servizio. Le intestazioni indicano a che punto sei.

Limite per IP

120 richieste ogni 10 minuti

Intestazioni di risposta

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

Errore 429

Restituito quando il limite è raggiunto. L’intestazione Retry-After indica il tempo di attesa.

Codici di errore

Ogni errore restituisce un JSON di forma costante, con un codice utilizzabile.

400Bad Request

Parametri non validi o mancanti

{
    "error": true,
    "message": "La lunghezza deve essere tra 4 e 128 caratteri",
    "code": "invalid_length"
}

429Too Many Requests

Limite di richieste superato

{
    "error": true,
    "message": "Limite di richieste raggiunto. Attendere 234 secondi",
    "retry_after": 234,
    "reset_at": "2026-01-15T10:35:00.000Z"
}

500Internal Server Error

Errore interno del server

{
    "error": true,
    "message": "Si è verificato un errore. Riprova."
}

503Service Unavailable

Servizio in manutenzione

{
    "error": true,
    "message": "Il sito è attualmente in manutenzione. Riprova tra qualche minuto."
}

Codici restituiti nel campo code

invalid_length
invalid_count
invalid_format
invalid_words
no_charset
empty_wordlist

Esempi di integrazione

La stessa chiamata, nel linguaggio che preferisci. Copia, incolla, adatta.

// 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');