Clima
Domínio responsável pela ingestão de dados meteorológicos de estações de campo: precipitação, temperatura, umidade, radiação e vento.
Endpoint
POST /v1/integrations/{partnerId}/clima
Autenticação: Authorization: Bearer {token} com role climate.write
Campos
Obrigatórios
| Campo | Tipo | Descrição |
|---|---|---|
idUsina |
number |
Identificador da Usina |
cdSafra |
string |
Safra agrícola (ex: "2023/2024") |
cdSetor |
string |
Código do Setor |
cdBloco |
string |
Código do Bloco |
cdFazenda |
string |
Código da Fazenda |
dtDataClima |
string |
Data/horário da estação — formato ISO 8601 YYYY-MM-DD |
Opcionais
Quando presentes, devem ser do tipo informado (null é aceito).
| Campo | Tipo | Descrição |
|---|---|---|
nrLatitudeEstacao |
number \| null |
Latitude da estação (graus decimais) |
nrLongitudeEstacao |
number \| null |
Longitude da estação (graus decimais) |
nrPrecipitacao |
number \| null |
Precipitação média diária (mm) |
nrTemperaturaMinima |
number \| null |
Temperatura mínima diária (°C) |
nrTemperaturaMaxima |
number \| null |
Temperatura máxima diária (°C) |
nrTemperaturaMedia |
number \| null |
Temperatura média diária (°C) |
nrUmidadeMinima |
number \| null |
Umidade relativa mínima (%) |
nrUmidadeMaxima |
number \| null |
Umidade relativa máxima (%) |
nrRadiacao |
number \| null |
Radiação solar média (MJ/m²) |
nrVelocidadeVento |
number \| null |
Velocidade do vento (m/s) |
Exemplo de payload
[
{
"idUsina": 1,
"cdSafra": "2023/2024",
"cdSetor": "SETOR01",
"cdBloco": "BLOCO01",
"cdFazenda": "FAZ001",
"dtDataClima": "2024-01-15",
"nrLatitudeEstacao": -22.9035,
"nrLongitudeEstacao": -47.0628,
"nrPrecipitacao": 45.2,
"nrTemperaturaMinima": 18.5,
"nrTemperaturaMaxima": 32.1,
"nrTemperaturaMedia": 25.3,
"nrUmidadeMinima": 55,
"nrUmidadeMaxima": 90,
"nrRadiacao": 18.4,
"nrVelocidadeVento": 12.5
}
]