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.
Autenticação
Seção intitulada “Autenticação”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).
Primeira chamada
Seção intitulada “Primeira chamada”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.
Ler uma tabela inteira
Seção intitulada “Ler uma tabela inteira”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.
Outras ferramentas de BI
Seção intitulada “Outras ferramentas de BI”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.