Neste artigo, vamos orientá-lo passo a passo do processo de autorização de AgFiniti, o software da plataforma AgLeader. Também ver
(Click here for English.)
Sumário
- Passo 0: Crie sua conta AgFiniti
- Passo 1: Obtenha suas credenciais de desenvolvedor da AgLeader
- Passo 2: Obtenha seus tokens AgLeader
- Passo 3: Crie um usuário Leaf com credenciais AgLeader no Leaf
As etapas a seguir são um passo a passo completo. Depois de seguir as etapas necessárias, você não precisará repeti-las nas chamadas subsequentes.
Passo 0: Criar uma conta de desenvolvedor com a AgLeader
Esta etapa pode ser pulada se você já tiver uma conta na AgLeader.
Por favor complete esse formulário para criar sua conta.
Passo 1: Obtenha as suas credenciais de desenvolvedor AgLeader
Acesse sua conta AgLeader.
Em seguida ,navegue até a aba “Chaves do Consumidor” e salve a chave pública e privada para uso posterior.
OBSERVAÇÃO: Mesmo que você esteja integrando com o Leaf, o AgLeader exigirá seu comprovante de seguro de responsabilidade e uma taxa única antes de fornecer credenciais de desenvolvedor.
Passo 2: Obtenha seus tokens AgLeader
Nesta etapa, vamos usar a URL /authorize para recuperar seus tokens: Bearer Token (Access Token) e Refresh Token.
Criando a URL de authenticação do usuário
Esta será a URL que você deverá direcionar seu usuário para obter autorização e informações das credenciais. Você precisará alterar os parâmetros {your_public_key} e o {redirect_uri}, conforme os dados da sua aplicação (tenha certeza que a URI está corretamente registrada como permitida na opção de "Redirection URLs" na configuração da sua aplicação na AgLeader):
Se você planeja permitir o envio de prescrições, você também precisará incluir o escopo fileupload na URL de autenticação.
Uma vez que você adicionou os parâmetros na URL, você poderá redirecionar o usuário para a página de autenticação. Esta URL terá os escopos necessários para uso da integração via Leaf API.
Obtendo o Refresh Token
Após o processo de autenticação, seu usuário será redirecionado para a redirect_uri informado na URL, e você poderá utilizar o parâmetro code adicionado pela AgLeader. Este será o código utilizado para obter o token.
Recupere o parâmetro code na sua página e POST ele para esta outra URL. Você precisará adicionar um header the "Authorization" com uma autenticação básica, utilizando suas publickey:privatekey, neste formato, encoded em base64. Por exemplo, se sua public key is "foo" e sua private key é "bar", então o "Authorization" header será "Basic Zm9vOmJhcg==".
Na resposta, você obterá o refresh_token para ser usado nos próximos passos.
Passo 3: Crie um usuário Leaf com credenciais AgLeader no Leaf
Suas credenciais AgFiniti devem estar vinculadas a um usuário Leaf para acessar os dados da conta AgFiniti do seu usuário. Depois de criar um usuário Leaf e adicionar essas credenciais ao usuário Leaf, os arquivos serão recuperados e então padronizados e estarão disponíveis dentro alguns minutos. Os arquivos de operação levarão várias horas para concluir o processamento.
1. PARA CRIAR UM USUÁRIO LEAF
POST para:
Com o seguinte cabeçalho:
Observação: veja como obter seu token Leaf
2. ADICIONE CREDENCIAIS AGLEADER AO SEU USUÁRIO LEAF
POST para:
Com o seguinte cabeçalho:
E com o seguinte JSON como payload da solicitação:
3. OBTENHA TODOS OS ARQUIVOS DAQUELE USUÁRIO DO LEAF
GET em:
Com o seguinte cabeçalho:
