Power Gains sur votre site

Accès

1. Disposer d’un compte ECU-LAB avec une formule active.
2. Dans votre compte → Clés API, créez une clé et indiquez les sites sur lesquels elle peut fonctionner.
3. Collez le code sur votre site (ou installez l’extension WordPress) et choisissez vos couleurs.

1 · Widget (JavaScript)

Deux lignes dans votre page. Le widget crée le sélecteur, dessine le graphique et le tableau, et s’adapte à la largeur de la page.

<div class="ecu-lab-gains" data-key="pk_…" data-lang="fr"></div>
<script src="https://ecu-lab.online/assets/widget/gains.js" async></script>

Attributs facultatifs :

data-key	votre clé publique (pk_…) — obligatoire
data-lang	langue : en, de, fr, it, es, pt, nl, pl, cs, sk, hu, no, ro, el, tr, sr, bg, uk, ru, zh, ja
data-category	cars · trucks · agro · moto · boats · machinery — afficher une seule catégorie (sinon, le visiteur choisit)
data-unit	hp · kw
data-colors	JSON avec les couleurs (noms dans le tableau ci-dessous)
data-color-hp-tuned …	une seule couleur, p. ex. data-color-hp-tuned="#ff6a00"
data-disclaimer	votre propre note sous le graphique (une note est toujours affichée)

2 · Iframe

Pour les constructeurs de pages qui n’acceptent pas les scripts. Sans bordure, fond transparent ; avec le script sur la page, la hauteur s’adapte au contenu.

<iframe class="ecu-lab-gains-frame" src="https://ecu-lab.online/embed/gains?key=pk_…&lang=fr&c_hp_tuned=ff6a00"
        style="border:0;width:100%;height:640px" loading="lazy" title="Power Gains"></iframe>
<script src="https://ecu-lab.online/assets/widget/gains.js" async></script>

Les couleurs se mettent dans l’adresse sous la forme c_<name>=rrggbb (sans #). L’iframe ne s’ouvre que sur les sites indiqués pour la clé.

3 · Extension WordPress

Installez l’extension, saisissez une fois votre clé secrète dans Réglages → ECU-LAB Power Gains, puis placez le shortcode ou le bloc « ECU-LAB Power Gains » où vous voulez. La clé reste sur votre serveur.

[ecu_lab_gains lang="fr" category="cars" hp_tuned="#ff6a00" nm_tuned="#0e2342"]

4 · Depuis votre serveur (REST)

Pour votre propre intégration : réponses JSON, authentifiées avec la clé secrète. Ne mettez jamais la clé secrète dans une page web.

curl -H "Authorization: Bearer sk_…" \
     "https://ecu-lab.online/api/v1/gains/vehicle/12345?lang=fr"

GET
/api/v1/gains/config	couleurs, catégories et textes dans la langue demandée
/api/v1/gains/categories	catégories avec le nombre de véhicules
/api/v1/gains/brands?category=cars	marques d’une catégorie
/api/v1/gains/models?category=cars&brand=…	modèles d’une marque
/api/v1/gains/years?category=cars&brand=…&model=…	années / générations d’un modèle
/api/v1/gains/engines?category=cars&brand=…&model=…&year=…	moteurs (id, nom, carburant)
/api/v1/gains/vehicle/{id}	puissance, couple, Stage 2 si disponible, points et axes du graphique

Paramètres communs : lang (langue des textes), unit=kw (puissance en kW au lieu de ch).

Couleurs du graphique

hp_tuned	Puissance — optimisée	#1f74e0
hp_stock	Puissance — origine	#8fa3b6
nm_tuned	Couple — optimisé	#e8a33b
nm_stock	Couple — origine	#b39b70
stage2	Stage 2	#7357d6
grid	Grille et lignes	#e2e9f1
text	Texte	#4a5d75
accent	Accent (champs sélectionnés)	#1f74e0
bg	Fond (ou « transparent »)	transparent

Toute couleur omise garde la valeur enregistrée sur votre clé, sinon la valeur par défaut.

Règles

• La clé publique ne fonctionne que sur les sites indiqués ; la clé secrète uniquement depuis un serveur.
• Limites par compte : 120 requêtes par minute, 20.000 par jour.
• Les valeurs sont des estimations et la note sous le graphique est toujours affichée.
• Les clés fonctionnent tant que le compte a une formule active ; elles s’arrêtent à l’expiration et refonctionnent au renouvellement.