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:
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.