API Plaque Immatriculation - Client JavaScript

Client JavaScript simple et professionnel pour l'API Plaque Immatriculation.

🚀 Installation

npm install apiplaqueimmatriculation

📖 Utilisation

Basique

const ApiPlaqueImmatriculation = require('apiplaqueimmatriculation');

const api = new ApiPlaqueImmatriculation('VOTRE_TOKEN');

// Recherche par plaque
const data = await api.getPlaque('AA-123-BC', 'FR');
console.log(data);

Avec gestion d'erreurs

try {
    const data = await api.getPlaque('AA-123-BC', 'FR');
    console.log('Véhicule trouvé:', data);
} catch (error) {
    console.error('Erreur:', error.message);
}

Avec options

const api = new ApiPlaqueImmatriculation('VOTRE_TOKEN', {
    timeout: 5000,  // 5 secondes
    baseUrl: 'https://api.apiplaqueimmatriculation.com'
});

React

import { useState } from 'react';
import ApiPlaqueImmatriculation from 'apiplaqueimmatriculation';

const api = new ApiPlaqueImmatriculation('VOTRE_TOKEN');

function RechercheVehicule() {
    const [immat, setImmat] = useState('');
    const [data, setData] = useState(null);
    const [loading, setLoading] = useState(false);

    const rechercher = async () => {
        setLoading(true);
        try {
            const result = await api.getPlaque(immat, 'FR');
            setData(result);
        } catch (error) {
            alert(error.message);
        }
        setLoading(false);
    };

    return (
        <div>
            <input 
                value={immat} 
                onChange={(e) => setImmat(e.target.value)}
                placeholder="AA-123-BC"
            />
            <button onClick={rechercher} disabled={loading}>
                {loading ? 'Recherche...' : 'Rechercher'}
            </button>
            {data && <pre>{JSON.stringify(data, null, 2)}</pre>}
        </div>
    );
}

Next.js (Server Component)

import ApiPlaqueImmatriculation from 'apiplaqueimmatriculation';

const api = new ApiPlaqueImmatriculation(process.env.API_TOKEN);

export default async function VehiculePage({ params }) {
    const data = await api.getPlaque(params.immat, 'FR');
    
    return (
        <div>
            <h1>{data.marque} {data.modele}</h1>
            <p>Année: {data.annee}</p>
        </div>
    );
}

🌍 Pays supportés

FR, ES, DE, IT, NL, PT, NL

console.log(ApiPlaqueImmatriculation.PAYS_SUPPORTES);

🔑 Obtenir un token

Rendez-vous sur apiplaqueimmatriculation.com pour créer un compte et obtenir votre token API.

📝 API

new ApiPlaqueImmatriculation(token, options)

Crée une instance du client.

Paramètres:

• token (string) - Token d'authentification API
• options (object) - Options facultatives
  • timeout (number) - Timeout en ms (défaut: 10000)
  • baseUrl (string) - URL de base de l'API

getPlaque(immatriculation, pays)

Recherche les informations d'un véhicule.

Paramètres:

• immatriculation (string) - Plaque d'immatriculation
• pays (string) - Code pays ISO (défaut: 'FR')

Retourne: Promise<Object> - Données du véhicule

checkToken()

Vérifie la validité du token.

Retourne: Promise<boolean>

📄 Licence

MIT © apiplaqueimmatriculation

🐛 Bugs & Support

GitHub Issues

🇫🇷 FR , 🇪🇸 ES , 🇬🇧 UK , 🇩🇪 DE ,🇮🇹 IT, 🇵🇹 PT,🇳🇱NL

## `.npmignore`

node_modules/ .git/ .gitignore *.test.js .env