O conteúdo desta página encontra-se em atualização e pode não refletir a situação atual. Algumas informações poderão estar incompletas ou sujeitas a alterações.
Agradecemos a sua compreensão. Caso necessite de assistência, não hesite em contactar a nossa equipa de suporte através do email [email protected].
⚙️ Visão geral da API Kropie
A API Kropie permite aceder de forma programática aos dados meteorológicos, estações, sensores e índices agronómicos disponíveis na plataforma.
Foi concebida para facilitar a integração dos dados da Kropie em aplicações externas, dashboards personalizados, modelos de decisão, sistemas de rega, ferramentas de investigação ou plataformas de gestão agrícola.
Com a API, é possível automatizar a recolha de dados, analisar séries temporais e cruzar informação climática e agronómica com outros sistemas.
🔑 Acesso à API
A API Kropie está disponível para utilizadores com conta ativa e validada.
O acesso é realizado através de uma chave API (API Key) única, associada à sua conta, que autentica todos os pedidos efetuados.
📩 Como solicitar acesso
Para solicitar acesso à API:
- Envie um email para [email protected]
- Utilize o assunto “API Access Request”
- Inclua:
- Email associado à conta Kropie
- Nome da organização ou projeto
- Breve descrição do caso de uso (opcional)
Após validação, receberá:
- A sua API Key
- Acesso à documentação técnica atualizada
🔐 A sua chave API é pessoal e não deve ser partilhada.
🔐 Autenticação
Todos os pedidos à API devem incluir a API Key no cabeçalho de autorização.
✅ Exemplo de pedido autenticado
GET https://api.kropie.com/v1/stations
Authorization: Bearer YOUR_API_KEY
⚠️ Nunca partilhe ou exponha a sua chave API em código cliente.
🌐 URL Base
Todos os pedidos usam o seguinte URL base:
https://api.kropie.com/v1/
📡 Endpoints disponíveis
De seguida são listados os principais endpoints para obter dados de estações, índices agronómicos, entre outros.
📍 1. Listar estações
Devolve a lista de todas as estações meteorológicas ligadas à sua conta Kropie.
GET /stations
Exemplo de resposta:
[
{
"id": "KRP001",
"name": "Vineyard South",
"status": "online",
"latitude": 41.188,
"longitude": -7.786
}
]
📊 2. Obter dados de uma estação
Devolve o histórico de leituras de uma estação específica.
GET /stations/{station_id}/data?start={start_date}&end={end_date}
Parâmetros:
| Nome | Tipo | Descrição |
|---|---|---|
| station_id | string | ID único da estação |
| start_date | date | Data de início do intervalo de dados (YYYY-MM-DD) |
| end_date | date | Data de fim do intervalo de dados (YYYY-MM-DD) |
Exemplo de resposta:
[
{
...
}
]
🌱 3. Obter Índices Agronómicos
Devolve os índices calculados, como Winkler, Huglin, Horas de Frio e Evapotranspiração.
GET /stations/{station_id}/indexes?start={start_date}&end={end_date}
Exemplo de resposta:
[
{
...
}
]
⏱️ 4. Dados mais recentes
Devolve as leituras mais recentes de uma determinada estação.
GET /stations/{station_id}/latest
Exemplo de resposta:
[
{
...
}
]
📡 5. Estado da estação
Permite verificar se uma estação está online ou offline.
GET /stations/{station_id}/status
Exemplo de resposta:
[
{
...
}
]
🧩 Formato dos dados
Todas as respostas são devolvidas em:
- Formato JSON
- Timestamps em UTC (ISO 8601)
- Valores normalizados por unidade
📊 Limites de requisições
Para garantir a estabilidade do serviço, Aplicam-se limites de utilização por chave API.
💡 Boas práticas
- Faça cache local das respostas para reduzir carga na API e melhorar desempenho
- Inclua sempre datas de início e fim para limitar o volume de dados
- Use HTTPS para transferências seguras
- Evite requisitar intervalos muito longos (divida em intervalos menores se necessário)
- Atualize a sua chave API regularmente por segurança
🧪 Casos de uso comuns
- Criação de dashboards personalizados alimentados com dados da Kropie
- Automatizar a gestão de irrigação
- Combinar dados de várias estações num relatório climático regional
- Integrar leituras da Kropie em plataformas externas de gestão agrícola