Hoje vamos apresentar a integração com a Stara através da Leaf começando pela criação da conta de desenvolvedor até o registro da credencial de um usuário na Leaf. Ao final, você terá feito uma integração com a Stara via Leaf para acessar os dados padronizados das máquinas; com a integração Stara, você poderá acessar nomes de talhões, limites de talhões, operações de plantio, operações de aplicação e informações de máquina. Todos os endpoints estão disponíveis em nossa documentação e também na coleção Postman.
(Click here for the translation in English.)
Sumário
- Passo 0: Criando uma conta de desenvolvedor na Stara
- Passo 1: Obtendo a API Key
- Passo 2: Obtendo os tokens de autenticação
- Passo 3: Registrando as credenciais da Stara na Leaf
Este post é um tutorial completo. Algumas etapas só serão necessárias uma vez, sendo que autenticações subsequentes serão mais rápidas e fáceis.
Passo 0: Criando Uma Conta De Desenvolvedor Na Stara
(Você pode pular esta etapa se você já possui uma conta de desenvolvedor na Stara.)
Entre em contato com a Stara para solicitar o acesso a API através do email: servicos@stara.com.br; ou telefone: +55 054 99706-7292. Você receberá o usuário e senha.
Assim que obter estes dados, você poderá avançar para a próxima etapa deste tutorial.
Passo 1: Obtendo A API Key
Para obter sua API Key você irá fazer um POST: https://v2apitelemetria.telemetriastara.com.br/autenticacao
Com o seguinte corpo:
A resposta será:
Passo 2: Obtendo Os Tokens De Autenticação
Neste passo, o endpoint irá gerar o acesso necessário e atualizar os tokens para todos as outras solicitações na API da Stara. Para obter seus tokens você fará um POST:
https://v2apitelemetria.telemetriastara.com.br/token
Com o seguinte corpo:`
A resposta será:
Passo 3: Registrando As Credenciais Da Stara Na Leaf
Nossa API usa uma abstração chamada Leaf User (usuário leaf) para armazenar as credenciais e organizar os dados para cada usuário. Na maioria dos casos, o Leaf User será um fazendeiro ou consultor que tenha acesso aos dados disponíveis nas companhias agrícolas (por exemplo Telemetria Stara)
Para enviar as suas credenciais para a Leaf, você precisará do seu token de acesso e que já possua um Leaf User registrado.
Aqui você poderá obter o seu token de acesso.
Aqui você verá como criar um Leaf User.
Para adicionar as suas credenciais Stara ao Leaf User criado, envie um POST para:
https://api.withleaf.io/services/usermanagement/api/users/{ {leaf_user_id} }/stara-credentials
Com o seguinte cabeçalho:
E com o seguinte JSON:
Excelente! Agora que você conectou as credenciais à Leaf, você pode começar a consultar dados da Stara. Nós recomendamos iniciar com field boundaries se você ainda não possui delimitações de talhão.
Os desenvolvedores de software usam a API da Leaf para construir e dimensionar uma ampla gama de produtos, incluindo ferramentas de otimização agrícola, produtos de empréstimo, financiamento baseado em resultados, mercados de terras e insumos, recomendações agronômicas, aplicativos de rastreabilidade, previsão de manutenção de equipamentos e muito mais.
