Skip to main content
Skip table of contents

Aegro API Pública

Visão Geral

Com a API pública da Aegro, ficou muito mais fácil de integrar outros sistemas e funcionalidades no Aegro. A API é uma interface pública de programação, através dela os parceiros podem ler e escrever informações no Aegro de forma programática. Dessa forma, é possível realizar o desenvolvimento de novas soluções visando a expansão das funcionalidades já existentes no ecossistema Aegro e a integração com novos sistemas.

Nossa API está em constante evolução. Aos poucos, estamos agregando mais possibilidades e funcionalidades a ela. Na próxima seção desse artigo há instruções de como entrar em contato para solicitar evoluções.

As funcionalidades disponíveis podem ser consultadas na nossa documentação técnica, através do link: API Pública da Aegro. Nesse link, a equipe técnica de desenvolvimento do sistema em questão pode verificar as funcionalidades disponíveis para integração, e entender melhor como utilizar a nossa API para realizar as integrações desejadas.

Como propor novas integrações ou solicitar novas funcionalidades na API

Se você é um produtor que utiliza nosso sistema e gostaria de integrar o seu Aegro com outra ferramenta, você pode enviar essa documentação para o desenvolvedor da ferramenta.

Se você é um desenvolvedor ou parceiro novo e gostaria de integrar com nosso sistema, tirar alguma dúvida que não esteja coberta na nossa documentação ou propor melhorias na API, você pode entrar em contato conosco pelo email integracoes@aegro.com.br.

Assunto: [Integração/Melhoria API] Proposta/sugestão de Integração com o (Nome do sistema)

  • Solicitante: (Nome da empresa ou da pessoa que deseja fazer uma nova integração)

  • Descrição: (Descrição resumida da integração que deseja realizar e qual o benefício ela trará aos produtores usuários da plataforma)

  • Dados: (Quais dados você acredita que deveria poder acessar ou escrever na plataforma para construir a integração)

Obs 1: Tente fornecer todas as informações que julgue necessárias para ajudar a entender melhor a necessidade, de forma que o nosso time possa processar e, eventualmente, priorizar a demanda.

Obs 2: Caso você não seja da equipe do sistema que deseja integrar, é importante validar com a empresa se eles têm interesse em fazer os desenvolvimentos técnicos necessários para efetuar a integração.

Como acessar as informações da fazenda via API (token de acesso)

Para que seja possível acessar aos dados da fazenda via API, é necessário um token de acesso. Cada token da acesso aos dados de uma única fazenda e pode ser configurado para ter apenas as permissões necessárias para a integração, bem com uma data de expiração.

Para solicitar o(s) token(s), o produtor, dono da conta e dos dados, deve enviar um e-mail para token@aegro.com.br, com cópia para o seu gerente de conta. Para localizar seu email de assinatura, clique na Inicial do nome de seu usuário e em Assinatura, conforme o gif:

email da assinatura.gif

Nesse e-mail, o produtor deve informar para qual fazenda e quais acessos quer liberar para uso através do token, além de uma data para expiração (por padrão será adotado 1 ano). O produtor proprietário receberá o token e é o responsável por ele, podendo compartilhar com a empresa/desenvolvedor da integração.

Assunto: [TOKEN] Solicitação de Token para Integração (Nome do sistema)

  • Nome: (Nome do produtor)

  • Fazenda: (Nome da fazenda para a qual deseja fornecer o acesso, 1 token por fazenda)

  • Integração: (Nome do sistema/parceiro que utilizará o token)

  • Permissões: (Para quais dados você quer dar acesso via token, leitura e/ou escrita)

  • Expiração: (Qual a data desejada para a expiração do token)

Obs: Caso você não saiba alguma dessas informações ou tenha alguma dúvida, pode conversar com seu gerente de conta ou enviar um texto no e-mail explicando a sua necessidade.

Por motivos de segurança, só serão aceitas solicitações provenientes do e-mail do proprietátio da assinatura dentro do Aegro.

No acesso via API, o token é a chave de autenticação e identificação. É possível gerar mais de um token, com diferentes permissões cada um. Recomendamos que evite compartilhar o mesmo token com mais de uma pessoa e utilize tokens diferentes para diferentes integrações, se for o caso.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.