API & MCP
Calculadora no seu site
O modo preview foi feito para calculadoras públicas: cotar sem poluir seus leads. Mas não coloque a chave no navegador, qualquer visitante a leria. O padrão seguro é um proxy no seu backend que injeta a chave:
<!-- Calculadora no seu site, NUNCA exponha a chave no navegador.
Chame o seu backend, e o SEU backend chama a ionluz com a chave. -->
<form id="calc">
<input name="consumo" type="number" placeholder="Consumo mensal (kWh)" required />
<select name="uf"><option>SP</option><option>MG</option><option>RJ</option></select>
<button>Simular economia</button>
</form>
<p id="resultado"></p>
<script>
document.getElementById("calc").onsubmit = async (e) => {
e.preventDefault();
const f = e.target;
// /minha-cotacao é uma rota SUA que injeta a chave e repassa p/ a ionluz (preview)
const r = await fetch("/minha-cotacao", {
method: "POST", headers: { "Content-Type": "application/json" },
body: JSON.stringify({ consumoKwhMes: +f.consumo.value, uf: f.uf.value }),
});
const { orcamento } = await r.json();
document.getElementById("resultado").textContent =
"Sistema de " + orcamento.potenciaKwp + " kWp, economia de R$ " +
orcamento.economiaMes1 + "/mês.";
};
</script>O seu endpoint /minha-cotacao recebe o consumo, chama https://app.ionluz.com.br/api/v1/quote com a chave (server-side, preview: true) e repassa só o orcamento ao navegador.
API v1 · ionluz, orçamentos solares. Dúvidas? Cite o
requestId ao escrever para suporte@ionluz.com.br.