Ferramentas, limites e créditos

Escopo dos resultados públicos e contrato previsto para a conexão MCP.

Dados e acesso público

Conjunto suportado

Carga de energia verificada do ONS (ons-verified-load), área SECO, métrica val_cargaglobal, em MWmed. A cobertura disponível é a indicada em cada resultado.

Preservação separada

Balanço de energia, ENA diária e EAR diária por subsistema não estão disponíveis como consultas nesta seção. Preservar arquivos não torna esses conjuntos produtos de consulta. Balanço não equivale a carga verificada.

Link e CSV

Leitura pública sem conta e sem consumo de créditos Wattdatum. Limites temporários de acesso podem restringir requisições repetidas.

Contrato MCP — ainda indisponível

As ferramentas e regras abaixo descrevem a integração preparada. Não comprovam conexão, saldo ou compra disponíveis em produção. Veja a situação do tutorial MCP.

query_series

Consulta uma série. Recebe dataset, area, metric, start e end. O campo opcional capture fixa o par captureId e normalizationId; sem ele, uma nova chamada resolve a última versão disponível.

get_saved_result

Reabre um resultado pelo resultId, mantendo as versões fixadas.

compare_captures

Recebe before e after, cada um com captura e normalização, e query com o mesmo escopo. Exige duas aquisições distintas, completas e compatíveis.

get_usage

Consulta gratuitamente o saldo, a tarifa e o histórico da própria conta. A próxima página usa beforeSequence com o cursor nextBeforeSequence, até ele ser null.

Limites e permissões previstos

• Série: até um dia, 48 linhas e 32 KiB no resultado de dados. Horários UTC com milissegundos, alinhados à meia hora; início incluído e fim excluído.
• maxRows e maxBytes podem reduzir os limites. Um resultado que não cabe é rejeitado, não truncado.
• MCP: corpo de até 16 KiB e resposta completa de até 128 KiB.
• Autorização OAuth: data:read para dados e usage:read para o uso da própria conta. Nenhuma dessas permissões autoriza compras.

Créditos e repetição previstos

Veja a oferta pré-paga, o saldo e a disponibilidade de compra em Preços e créditos. Sem assinatura, recorrência ou recarga automática.

Uma nova chamada bem-sucedida pode gerar nova cobrança, mesmo com os mesmos argumentos. A repetição interna da mesma operação não deve cobrar novamente. A deduplicação entre chamadas exige um identificador estável de operação aceito pelo cliente; não está comprovada no cliente do tutorial.

O recibo identifica a operação e o débito. Seu saldo é histórico: para saber o saldo atual, será necessário consultar get_usage. Se a resposta se perder após o sucesso, o débito pode já ter ocorrido; não repita uma chamada presumindo que ela será gratuita.

Ausência e falhas

null em um valor significa ausência, não zero. Captura desconhecida, versão retirada, período fora da cobertura e comparação incompatível retornam indisponibilidade ou falha explícita. Falha de autorização ou saldo insuficiente não entrega dados como se a operação tivesse sido concluída.