Introdução

Olá, seja bem-vindo à Plataforma de Integrações Aegro. Aqui você encontra a documentação para integrar sistemas com a Aegro, acessar dados da fazenda de forma programática e automatizar fluxos de trabalho.

Recursos Importantes

Acesse rapidamente o que você precisa:

Visão Geral do Modelo de dados Swagger com as Operações da API MCP (Model Context Protocol) [EM BREVE]

Modelo de dados — Explica propriedade, safra, talhão, talhão de safra e como os recursos se relacionam. Recomendado antes de começar a integrar.

Operações da API (Swagger) — Referência técnica da API REST: todas as operações, parâmetros, exemplos e detalhes para integração.

Sobre a API REST

A API é stateless: todas as solicitações são validadas contra um token de API, enviado no header Aegro-Public-API-Key. Cada token dá acesso aos dados de uma única fazenda.

Exemplo de chamada:

curl -X GET 'https://app.aegro.com.br/pub/v1/farms' \
  -H 'Aegro-Public-API-Key: <SEU_TOKEN>'

Como obter acesso

O token de API deve ser solicitado pelo e-mail token@aegro.com.br. Apenas o proprietário da assinatura pode solicitar tokens. Dúvidas ou suporte: integracoes@aegro.com.br.

Conceitos-chave

Token: O acesso à API é feito com um token no header Aegro-Public-API-Key. Cada token está vinculado a uma única fazenda.
Paginação: Listagens usam paginação (página, tamanho, ordenação). Veja o Swagger em cada operação.
Filtros: Várias operações expõem filter (POST com corpo JSON) para buscar por critérios.
Chave: Todo recurso possui uma chave no formato tipo::identificador. Use-as para referenciar recursos em filtros e relacionamentos.

Suporte e links úteis

A Plataforma de Integrações Aegro está sob os mesmos termos de uso e política de privacidade dos demais produtos e serviços da Aegro.