Precipitação

Registre chuva ou volume de água acumulado em milímetros. Ideal para estações meteorológicas ou sistemas de irrigação.

Faixa e unidade

• type: "mm"
• value: 0.0 a 100.0

Campos

• value: precipitação acumulada em mm no intervalo.
• type: sempre "mm".
• timestamp: data/hora em ISO 8601 (UTC recomendado), preferencialmente o fim do intervalo medido.
• location: { "type": "point", "value": [lon, lat] }.
• description (opcional): contexto do período de coleta.

Exemplo de payload

{
  "precipitation": {
    "value": 2.4,
    "type": "mm",
    "description": "Acúmulo nas últimas 24h",
    "location": {
      "type": "point",
      "value": [-46.7231, -23.5623]
    },
    "timestamp": "2025-12-18T12:00:00Z"
  }
}

Envie 0 quando não houver chuva no período para manter a série consistente e evitar lacunas na visualização.

Exemplo rápido em Python (requests)

import os
import requests, datetime

API_BASE = os.environ["NEXT_PUBLIC_API_BASE_URL"]
TOKEN = "SEU_TOKEN_DO_DISPOSITIVO"

payload = {
    "precipitation": {
        "value": 2.4,
        "type": "mm",
        "description": "Acúmulo nas últimas 24h",
        "location": {"type": "point", "value": [-46.7231, -23.5623]},
        "timestamp": datetime.datetime.now(datetime.timezone.utc).isoformat(),
    }
}

requests.post(
    f"{API_BASE}/v1/secure/measures",
    headers={"Authorization": f"Bearer {TOKEN}", "Content-Type": "application/json"},
    json=payload,
    timeout=10,
)