Power Gains no seu site

Acesso

1. Ter uma conta ECU-LAB com um plano ativo.
2. Na sua conta → Chaves API, crie uma chave e indique os sites onde pode funcionar.
3. Cole o código no seu site (ou instale o plugin WordPress) e escolha as suas cores.

1 · Widget (JavaScript)

Duas linhas na sua página. O widget cria o seletor, desenha o gráfico e a tabela e adapta-se à largura da página.

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

Atributos opcionais:

data-key	a sua chave pública (pk_…) — obrigatória
data-lang	idioma: 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 — mostrar apenas uma categoria (sem ele, o visitante escolhe)
data-unit	hp · kw
data-colors	JSON com as cores (nomes na tabela abaixo)
data-color-hp-tuned …	uma única cor, p. ex. data-color-hp-tuned="#ff6a00"
data-disclaimer	a sua própria nota por baixo do gráfico (é sempre mostrada uma nota)

2 · Iframe

Para construtores de páginas que não aceitam scripts. Sem margem, fundo transparente; com o script na página, a altura ajusta-se ao conteúdo.

<iframe class="ecu-lab-gains-frame" src="https://ecu-lab.online/embed/gains?key=pk_…&lang=pt&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>

As cores vão no endereço como c_<name>=rrggbb (sem #). O iframe só abre nos sites indicados na chave.

3 · Plugin WordPress

Instale o plugin, introduza uma vez a sua chave secreta em Definições → ECU-LAB Power Gains e coloque o shortcode ou o bloco «ECU-LAB Power Gains» onde quiser. A chave fica no seu servidor.

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

4 · A partir do seu servidor (REST)

Para a sua própria integração: respostas JSON, autenticadas com a chave secreta. Nunca coloque a chave secreta numa página web.

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

GET
/api/v1/gains/config	cores, categorias e textos no idioma pedido
/api/v1/gains/categories	categorias com o número de veículos
/api/v1/gains/brands?category=cars	marcas de uma categoria
/api/v1/gains/models?category=cars&brand=…	modelos de uma marca
/api/v1/gains/years?category=cars&brand=…&model=…	anos / gerações de um modelo
/api/v1/gains/engines?category=cars&brand=…&model=…&year=…	motores (id, nome, combustível)
/api/v1/gains/vehicle/{id}	potência, binário, Stage 2 quando disponível, pontos e eixos do gráfico

Parâmetros comuns: lang (idioma dos textos), unit=kw (potência em kW em vez de cv).

Cores do gráfico

hp_tuned	Potência — modificada	#1f74e0
hp_stock	Potência — original	#8fa3b6
nm_tuned	Binário — modificado	#e8a33b
nm_stock	Binário — original	#b39b70
stage2	Stage 2	#7357d6
grid	Grelha e linhas	#e2e9f1
text	Texto	#4a5d75
accent	Destaque (campos selecionados)	#1f74e0
bg	Fundo (ou «transparent»)	transparent

Qualquer cor omitida mantém o valor guardado na chave e, caso não exista, o predefinido.

Regras

• A chave pública só funciona nos sites indicados; a chave secreta só a partir de um servidor.
• Limites por conta: 120 pedidos por minuto, 20.000 por dia.
• Os valores são estimativas e a nota por baixo do gráfico é sempre mostrada.
• As chaves funcionam enquanto a conta tiver um plano ativo; param quando expira e voltam a funcionar com a renovação.