API & MCP

Cobertura

GET/api/v1/coverage

Descobre quais faixas × fase você atende antes de cotar, assim seu sistema (ou agente) evita o errofaixa-nao-atendida em runtime. Mesma autenticação por chave.

curl https://app.ionluz.com.br/api/v1/coverage -H "Authorization: Bearer ilz_sua_chave"

{
  "ok": true,
  "modo": "custo",
  "ativa": true,
  "cobertas": 5,
  "total": 6,
  "tetoKw": 75,
  "unidadeFaixas": "kw-saida-inversor",
  "fases": [ { "key": "mono", "label": "Monofásico" }, ... ],
  "matriz": [
    { "fase": "mono", "deKw": 0,  "ateKw": 3,  "atende": true },
    { "fase": "mono", "deKw": 3,  "ateKw": 10, "atende": true },
    { "fase": "tri",  "deKw": 0,  "ateKw": 75, "atende": false }
  ],
  "requestId": "req_..."
}

As faixas são do integrador (editáveis, a matriz pode mudar) e são denominadas em kW de saída de inversor (CA), na régua de 0 a tetoKw (75 kW, o limite da microgeração). Cada célula de matriz vai de deKw a ateKw e diz se aquela combinação com fase tem um kit precificável (atende: true). Fase com combinação automática aparece como uma faixa única, de 0 a 75.