Pular para o conteúdo

Código e outras ferramentas

Qualquer ferramenta que faça uma requisição HTTP lê a OpenAGROs. As respostas são JSON no formato OData v4.

Envie o token em um destes cabeçalhos:

Authorization: Bearer oag_…
x-api-key: oag_…

Ferramentas que só sabem usuário e senha podem usar Basic, com o token como senha (o usuário é ignorado).

Janela do terminal
curl -H "Authorization: Bearer $OPENAGROS_TOKEN" \
"https://platform.agrosti.com.br/v2/apontamentos?\$select=controle,data,operacao,horas&\$top=1"
{
"@odata.context": "https://platform.agrosti.com.br/v2/$metadata#apontamentos(controle,data,operacao,horas)",
"value": [{ "controle": 81234, "data": "2026-01-02", "operacao": "Pulverização", "horas": 7.5 }]
}

O documento de serviço (/v2/) lista as tabelas que o token pode ler. O $metadata traz os tipos e as descrições de cada coluna.

Cada resposta traz até 5.000 linhas. Quando há mais, ela traz @odata.nextLink: siga o link até ele não vir mais. Não monte o link você mesmo.

import os
import requests
url = "https://platform.agrosti.com.br/v2/apontamentos_talhoes"
params = {"$filter": "data ge 2026-01-01 and data lt 2026-02-01"}
headers = {"Authorization": f"Bearer {os.environ['OPENAGROS_TOKEN']}"}
linhas = []
while url:
resposta = requests.get(url, params=params, headers=headers, timeout=60)
resposta.raise_for_status()
corpo = resposta.json()
linhas.extend(corpo["value"])
url, params = corpo.get("@odata.nextLink"), None
print(len(linhas))

Respeite o limite por minuto: ao receber 429, espere os segundos de Retry-After e repita a mesma página.

Ferramentas com conector OData v4 usam o endereço https://platform.agrosti.com.br/v2/ e a autenticação Basic. As opções de consulta estão em Consultas.