SOLARZ-MONITORAMENTO

📥 Como criar API da Elekeeper

Este artigo tem como objetivo apresentar o passo a passo para a criação da API do portal Elekeeper.
Siga as instruções abaixo para realizar o processo corretamente:

1 - No canto superior direito da tela, clique no ícone de Aplicativos (quatro quadrados), no menu que será exibido, selecione a opção Open Platform.

image-20260709-182818.png

2 - Na tela de apresentação da plataforma, clique no botão Start Now.

image-20260709-183247.png

3 - Na tela seguinte, em Autonomous Account, clique em Create Developer Organization para criar sua organização de desenvolvedor.

image-20260709-183323.png

4- Como criar uma organização de desenvolvedor na Elekeeper

  1. Após clicar em Create Developer Organization, será exibido o formulário para criação da organização.

  2. Preencha as informações solicitadas em Informações básicas, como:

    • Nome da empresa desenvolvedora;

    • Abreviação da empresa;

    • Representante legal;

    • País/Região;

    • Endereço da organização;

    • Site oficial (opcional, se aplicável);

    • Introdução da empresa desenvolvedora;

    • Anexe a licença comercial ou outro documento comprobatório da empresa.

  3. Em Informações do usuário desenvolvedor, informe:

    • Nome do contato;

    • Cargo;

    • Telefone;

    • E-mail;

    • Cartão de visita (opcional).

image-20260709-183650.png

5 - Escreva algum texto em inglês na parte “Developer Enterprise Introduction” como: nome da empresa is a Brazilian installer of pv systems. We are using the Elekeeper API to provide better integration with our company’s partners.

image-20260709-184133.png

6 - Após a análise ajuste as permissões para dar autorização à sua organização

image-20251112-202537.png


Dessa forma a tela anterior deve ficar

image-20251112-202629.png


Criando um app para obter os tokens de api

7 - Para checar seu acesso ao portal de desenvolvimento entre no portal de desenvolvimento clique em “Enter Open Platform” ou use o endereço http://intl-developer.saj-electric.com , realize o login com o usuário e senha criados no passo (ref).

image-20251112-202653.png


8 - A liberação pode demorar mais de 1 dia. Quando sua conta estiver liberada no portal de desenvolvimento, acesse o portal e clique em “console > app”

image-20251112-202726.png

9 - Na tela seguinte clique no botão “Create na app” mostrado na figura (ref) à cima, e preencha os dados pedidos de acordo com o esquema abaixo:

App name: “Nome integrador – Solarz”, ex: olisun – solarz

App note: “Integration with solarz and olisun through open api”

App Image: Use a imagem do modal de usinas, como a imagem (ref)

 

image-20251112-195212.png

10 - Após isso clique no botão “confirm”. Após isso o app ficará listado na tela.

image-20251112-202825.png


 Clique no app para ir à tela de configurações e na tela seguinte clique em “Settings and Development > app configuration”

image-20251112-202909.png


11 - As informações aqui são as mesmas inseridas na tela de configurações inicial, porém será possível gerar um app key, acessando o menu “Development Configuration”, destacado na figura (ref).

image-20251112-202946.png


12 - Nesse menu clique em “Generate” abaixo de “App secret”. A tela que será exibida irá conter o secret gerado, copie e salve-o em algum lugar, essa informação será necessária para cadastrar a credencial na solarz. O App id também será necessário, e pode ser obtido nesta mesma tela abaixo de “App id”.

Prossiga para o a seção “Apply for Release” e clique no botão “Submitt for Review”.

image-20251112-203009.png


13 - O processo de revisão é feito pelo pessoal do portal raiz, após a revisão o app id e secret poderão ser usados na solarz.

Após a submissão, é necessário esperar por algum tempo até que seja analisado pelo portal raiz. Após a análise, caso esteja tudo ok, na seção “Product Release” o botão “Release” irá aparecer.

image-20251112-203059.png


14 - Ao clicar no botão release, o appId e appSecret gerados estarão prontos para serem usados na solarz.