# Agroop API

> A Agroop API permite aceder de forma simples e segura aos dados recolhidos pelos equipamentos fornecidos ou integrados pela Agroop, como sensores, sondas e dispositivos de monitorização agrícola. A documentação inclui instruções sobre autenticação, estrutura das respostas e exemplos de utilização para facilitar a integração com sistemas externos.

## Docs

- [Introdução](https://docs.agroop.net/index.md): Agroop API
- [Subscrição](https://docs.agroop.net/subscription.md): A Agroop API requer uma subscrição ativa para gerar a sua API Key e aceder aos dados.
- [Equipamentos](https://docs.agroop.net/devices.md): Equipamentos disponíveis na API
- [API Key](https://docs.agroop.net/api-key.md): Como obter a API Key para autenticação
- [Autenticação](https://docs.agroop.net/authentication.md): Como autenticar pedidos à Agroop API
- [Gerar token](https://docs.agroop.net/endpoint/access-token.md): Gera um token temporário que será enviado por e-mail para recuperar a API Key.
- [Gerar API Key](https://docs.agroop.net/endpoint/access.md): Com o token temporário (que só pode ser utilizado uma vez), devolve a API Key da sua entidade.
- [Revogar API Key](https://docs.agroop.net/endpoint/access-revoke.md): Revoga a API Key atualmente utilizada.
- [Listar equipamentos](https://docs.agroop.net/endpoint/devices.md): Devolve uma lista de todos os equipamentos disponíveis, identificados pelo respetivo identificador único.
- [Obter informação do equipamento](https://docs.agroop.net/endpoint/device-info.md): Devolve a localização, as interfaces e a subscrição do equipamento identificado.
- [Obter leituras do equipamento](https://docs.agroop.net/endpoint/device-readings.md): Devolve uma lista de leituras de um equipamento num determinado período. Todos os valores de data e hora, incluindo timestamps, são expressos em UTC.
- [Interfaces](https://docs.agroop.net/interfaces.md): Descrição e unidades de medida das interfaces disponíveis na Agroop API.
- [Limites de utilização](https://docs.agroop.net/tracking.md): Limites de utilização e boas práticas da Agroop API.

## OpenAPI Specs

- [openapi](https://docs.agroop.net/openapi.json)

## Optional

- [Agroop](https://agroop.net)
- [Farmoot](https://app.agroop.net)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.