SOLARZ-MONITORAMENTO
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:

Passo 1: Acesso Ơ PƔgina Inicial e Cadastro

  1. Acesse o site oficial da plataforma de desenvolvimento: https://intl-developer.saj-electric.com/

  2. No canto superior direito da tela, clique em "Sign Up" (Cadastrar-se).

    image-20260924-191357.png

Passo 2: CriaĆ§Ć£o da Conta (Credenciais de Acesso)

Na janela de registro que se abrir, preencha os campos solicitados:

  1. Email ID: Digite o seu endereƧo de e-mail e clique no botĆ£o verde "Send Verification Code".

    image-20260924-191420.png

  2. Verification Code: Insira o cĆ³digo de verificaĆ§Ć£o recebido no seu e-mail.

  3. Set Password: Crie uma senha (deve conter entre 8 e 20 caracteres, combinando letras, nĆŗmeros e pontos).

  4. Confirm Password: Confirme a senha digitada.

  5. Marque as caixas de seleĆ§Ć£o aceitando os termos de acordo de serviƧo e polĆ­tica de privacidade.

  6. Clique no botĆ£o "Sign Up" na parte inferior para avanƧar.

Passo 3: InformaƧƵes da OrganizaĆ§Ć£o (Etapa 1)

Nesta primeira etapa de perfil, preencha os dados da empresa:

image-20260924-191518.png

  1. Nome da organizaĆ§Ć£o: Informe o nome completo da empresa (ex: Solarz).

  2. Nome abreviado da organizaĆ§Ć£o: Informe a sigla ou nome curto (ex: Solarz).

  3. Representante Legal: Digite o nome do responsƔvel.

  4. EndereƧo da organizaĆ§Ć£o: Selecione o paĆ­s, estado e insira o endereƧo detalhado.

  5. LicenƧa Comercial: FaƧa o upload de 1 arquivo nos formatos JPG/PNG (com menos de 9 MB).

  6. ApresentaĆ§Ć£o da organizaĆ§Ć£o: Escreva uma breve descriĆ§Ć£o da empresa e da integraĆ§Ć£o pretendida.

  7. Clique no botĆ£o verde "PrĆ³ximo".

    image-20260924-191538.png

Passo 4: Detalhes de Contato (Etapa 2)

Preencha as informaƧƵes de contato do responsƔvel:

  1. Nome: Digite o seu nome.

  2. TĆ­tulo / Cargo: (Opcional) Informe o seu cargo na empresa.

  3. Telefone: (Opcional) Insira o cĆ³digo do paĆ­s e o nĆŗmero de telefone.

  4. EndereƧo de e-mail: Confirme o e-mail de contato.

  5. CartĆ£o de visita: (Opcional) FaƧa o upload de uma imagem do cartĆ£o de visita (JPG/PNG com menos de 9 MB).

  6. Clique em "PrĆ³ximo".

    image-20260924-191557.png

Passo 5: IntenĆ§Ć£o de CooperaĆ§Ć£o e FinalizaĆ§Ć£o (Etapa 3)

  1. Nome do Gerente de Contas: (Se aplicƔvel) Insira o nome do seu gerente de contas.

  2. Como vocĆŖ conheceu esta plataforma? Selecione a opĆ§Ć£o correspondente no menu suspenso.

  3. Leia os termos referentes ao tratamento de dados e baixe/assine o Contrato de Processamento de Dados caso solicitado, enviando-o assinado para o e-mail indicado (dataprotection@saj-electric.com).

  4. Marque a caixa de concordĆ¢ncia com os termos de proteĆ§Ć£o de dados.

  5. Clique no botĆ£o "Enviar".

    image-20260924-191805.png

Passo 6: ConclusĆ£o

ApĆ³s o envio, aparecerĆ” a mensagem de confirmaĆ§Ć£o: "Sua inscriĆ§Ć£o foi recebida com sucesso". Basta aguardar a verificaĆ§Ć£o e o retorno da equipe atravĆ©s do seu e-mail cadastrado dentro do prazo de 1 dia Ćŗtil.

image-20260924-191816.png


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

Passo 8: 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: nome da integradora ā€“ solarz

App note: ā€œIntegration with solarz and ā€˜nome da integradoraā€™ through open apiā€

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

 

image-20251112-195212.png

Passo 9: 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


Passo 10: 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


Passo 11: 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


Passo 12: 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


Passo 13: Ao clicar no botĆ£o release, o appId e appSecret gerados estarĆ£o prontos para serem usados na solarz.