Documentação

Autenticação

Todas as requisições exigem uma API key no header. Solicite sua chave pelo pré-cadastro.

Authorization: Bearer YOUR_API_KEY

Inclua o header em todas as requisições. Chaves são vinculadas à sua conta e permitem rate limiting por plano.

Farms API

Gerenciamento de fazendas, talhões e blocos produtivos.

GET /api/v2/farms Lista todas as fazendas do usuário autenticado.

GET /api/v2/farms/{id} Detalhes de uma fazenda específica, incluindo localização e área total.

GET /api/v2/farms/{id}/blocks Lista todos os talhões/blocos de uma fazenda com geometria GeoJSON.

POST /api/v2/farms Cadastra uma nova fazenda com nome, localização e geometria.

Clima API

Dados climáticos diários com modelo FAO-56 Penman-Monteith. VPD, ET0, GDD e balanço hídrico.

GET /api/v2/farms/{id}/clima/today Dados climáticos do dia atual: temperatura, umidade, VPD, ET0, GDD.

GET /api/v2/farms/{id}/clima/forecast Previsão climática para os próximos 7 dias.

GET /api/v2/farms/{id}/clima/history Histórico climático com filtros de data. Até 365 dias retroativos.

GET /api/v2/farms/{id}/clima/gdd Graus-dia acumulados para acompanhamento fenológico.

Weather API

Alertas meteorológicos e janelas de aplicação para manejo.

GET /api/v2/farms/{id}/weather/forecast Previsão meteorológica detalhada com precipitação, vento e nebulosidade.

GET /api/v2/farms/{id}/weather/frost-risk Risco de geada com antecedência de até 4 meses (modelo proprietário).

GET /api/v2/farms/{id}/weather/dry-spell Detecção de veranicos e períodos secos prolongados.

GET /api/v2/farms/{id}/weather/spray-window Janelas ideais para pulverização baseadas em vento, umidade e chuva.

EUDR API

Compliance com a regulação europeia anti-desmatamento. Análise automática e geração de certificados.

GET /api/v2/farms/{id}/eudr/assessment Avaliação completa de compliance EUDR: cobertura vegetal, áreas protegidas, histórico.

GET /api/v2/farms/{id}/eudr/certificate Gera certificado de compliance em formato PDF com verificação blockchain.

Carbon API

Estimativas de carbono por talhão e fazenda para mercado voluntário.

GET /api/v2/carbon/estimate/{block_id} Estimativa de estoque de carbono por talhão (tCO2e).

GET /api/v2/carbon/farm/{id}/summary Resumo consolidado de carbono da fazenda com totais e histórico.

Blockchain API

Verificação e prova de dados on-chain via contrato Polygon.

GET /api/v1/blockchain/verify/{hash} Verifica a integridade de um registro pelo hash on-chain.

GET /api/v1/blockchain/proof/{hash} Retorna a prova de Merkle e metadados do registro verificado.