Intégrer une API REST Automobile en 10 Minutes

Ce guide vous montre comment intégrer l’API d’identification véhicule Auto Ways Network dans votre application en moins de 10 minutes — avec des exemples de code en PHP, Python et JavaScript.

Prérequis

• Un compte Auto Ways Network (démo gratuit : app.auto-ways.net/demo)
• Votre token API (disponible dans votre espace client)
• Connaissance de base des requêtes HTTP

Endpoint API

GET https://app.auto-ways.net/api/v1/fr

Paramètres

Exemples de Code

PHP (cURL)

<?php
$token = 'VOTRE_TOKEN';
$plaque = 'AA000AA';

$url = "https://app.auto-ways.net/api/v1/fr?token={$token}&plaque={$plaque}";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

echo "Véhicule : " . $data['AWN_label'] . PHP_EOL;
echo "Puissance : " . $data['AWN_puissance_chevaux'] . " ch" . PHP_EOL;
echo "CO2 : " . $data['AWN_emission_co_2'] . " g/km" . PHP_EOL;

Python (requests)

import requests

token = 'VOTRE_TOKEN'
plaque = 'AA000AA'

url = f'https://app.auto-ways.net/api/v1/fr'
params = {'token': token, 'plaque': plaque}

response = requests.get(url, params=params)
data = response.json()

print(f"Véhicule : {data['AWN_label']}")
print(f"Puissance : {data['AWN_puissance_chevaux']} ch")
print(f"CO2 : {data['AWN_emission_co_2']} g/km")
print(f"K-Type TecDoc : {data['AWN_tecdoc_modele_id']}")

JavaScript (fetch)

const token = 'VOTRE_TOKEN';
const plaque = 'AA000AA';

const url = `https://app.auto-ways.net/api/v1/fr?token=${token}&plaque=${plaque}`;

fetch(url)
  .then(response => response.json())
  .then(data => {
    console.log('Véhicule :', data.AWN_label);
    console.log('Puissance :', data.AWN_puissance_chevaux, 'ch');
    console.log('CO2 :', data.AWN_emission_co_2, 'g/km');
  });

Format de la Réponse JSON

La réponse contient plus de 100 champs. Voici les plus utilisés :

{
  "AWN_label": "RENAULT CLIO IV (BH_) 1.5 dCi 90",
  "AWN_marque_carrosserie": "RENAULT",
  "AWN_energie": "GAZOLE",
  "AWN_puissance_chevaux": "90",
  "AWN_puissance_KW": "66",
  "AWN_puissance_fiscale": "5",
  "AWN_emission_co_2": "104",
  "AWN_nbr_cylindres": "4",
  "AWN_nbr_portes": "5",
  "AWN_couleur": "GRIS CLAIR",
  "AWN_type_boite_vites": "MECANIQUE",
  "AWN_tecdoc_modele_id": "10852",
  "AWN_tecdoc_modele_description": "CLIO 4",
  "AWN_codes_moteur": ["K9K_608", "K9K_638"],
  "AWN_date_derniere_carte_grise": "15-03-2019"
}

Gestion des Erreurs

response = requests.get(url, params=params)

if response.status_code == 200:
    data = response.json()
    # traiter les données
elif response.status_code == 401:
    print("Token invalide")
elif response.status_code == 404:
    print("Véhicule non trouvé")
else:
    print(f"Erreur : {response.status_code}")

Bonnes Pratiques

1. Mettre en cache les réponses — les données véhicule ne changent pas souvent
2. Valider la plaque avant l’envoi (format SIV : XX-000-XX)
3. Gérer les valeurs INCONNU — certains champs peuvent retourner "INCONNU" si la donnée n’est pas disponible
4. Ne pas exposer votre token côté client — faites les appels depuis votre backend

Ressources

• Documentation complète
• Référence SwaggerHub
• Référence des 100+ champs
• Démo gratuite
• Tarifs