Este tutorial mostra, passo a passo, como os integradores devem criar e configurar sua conta no novo portal de desenvolvedor da SolarEdge para obter acesso Ć API.
Para usar a nova API da SolarEdge, vocĆŖ deve ativar sua conta no portal de desenvolvedor:
https://developer.solaredge.com
Etapa 1: Acesse o portal e faƧa login
ApĆ³s clicar no link acima, vocĆŖ serĆ” direcionado para a pĆ”gina inicial do portal de desenvolvedor. Caso vocĆŖ jĆ” tenha uma conta na SolarEdge, clique em "Login", no canto superior direito da tela (destacado em vermelho na imagem abaixo).
Caso ainda nĆ£o tenha uma conta, utilize o botĆ£o "Sign up" para criar uma nova conta antes de prosseguir.
Etapa 2: FaƧa login com suas credenciais
Na tela de login, informe o e-mail e a senha da sua conta SolarEdge nos campos "Email address" e "Password" e clique em "Sign in". Caso vocĆŖ utilize um e-mail corporativo cadastrado, tambĆ©m Ć© possĆvel entrar pela opĆ§Ć£o "Corporate email", exibida logo abaixo.
Etapa 3: Complete os dados da conta e ative o acesso de desenvolvedor
Preencha as informaƧƵes solicitadas no formulĆ”rio (paĆs, cidade, endereƧo, CEP, estado, nome e sobrenome de contato). Em seguida, preencha os dois campos destacados em vermelho:
-
"Type of industry": selecione o segmento que melhor descreve sua empresa;
-
"Expected monthly API usage": selecione a expectativa de uso mensal da API.
Depois de preencher os dados, clique no botĆ£o laranja "Activate Developer Access", tambĆ©m destacado em vermelho, para ativar o acesso de desenvolvedor.
Etapa 4: Escolha o seu plano
Na sequĆŖncia, o portal exibirĆ” os planos disponĆveis (Free, Business Starter, Business Growth, Business Pro e Enterprise), com o nĆŗmero de crĆ©ditos mensais e limites de chamadas de cada um. Escolha o plano mais adequado ao seu uso e clique em "Get Started" ou "Choose Plan" no plano desejado.
Ć importante dizer que a integraĆ§Ć£o agora Ć© muito mais limitada no formato gratuito, porĆ©m tem um formato pago que deve resolver a maioria dos problemas. VocĆŖ pode verificar os preƧos em https://api-docs.solaredge.com/docs/developer-platform/pwh8p4k2wtajh-tiers-and-rate-limits#billing-and-subscriptions , alĆ©m do suporte da Solar Edge.
Etapa 5: Crie a sua aplicaĆ§Ć£o
Na etapa "Add Site Details", preencha os campos destacados em vermelho:
-
"Application Name": informe um nome para identificar a sua aplicaĆ§Ć£o;
-
"Description": descreva brevemente o que a aplicaĆ§Ć£o faz e como ela utiliza os dados solares.
Em "Select API Service", mantenha selecionada a opĆ§Ć£o "Monitoring API" (as opƧƵes "Fleet Management API" e "Designer API" ainda estĆ£o planejadas e nĆ£o disponĆveis). Por fim, clique no botĆ£o "Next", destacado em vermelho, para avanƧar.
Etapa 6: Selecione o tipo de acesso
Na etapa "Select Access Type", selecione a opĆ§Ć£o "My Fleet Access" (destacada em vermelho), pois ela habilita o acesso a todos os sites do fleet da sua prĆ³pria conta, sendo a opĆ§Ć£o indicada para instaladores e gestores de fleet.
Em seguida, defina em "Requested Access Duration" o perĆodo de validade do acesso solicitado (destacado em vermelho) ā no exemplo, 12 meses ā e avance para a prĆ³xima etapa.
Etapa 7: Salve sua API Key
Ao final do processo, a aplicaĆ§Ć£o serĆ” criada e sua API Key serĆ” gerada. AtenĆ§Ć£o: a chave Ć© exibida apenas uma vez e nĆ£o pode ser recuperada posteriormente, portanto Ć© fundamental salvĆ”-la em um local seguro.
Clique no Ćcone de cĆ³pia ao lado do campo "API Key" (destacado em vermelho) para copiar a chave, ou utilize o botĆ£o "Download as .env" para baixĆ”-la em um arquivo. Depois de guardar a chave com seguranƧa, marque a caixa "I have saved my credentials securely" e clique em "Done" para concluir.
Como gerar uma nova API Key
Caso o cliente perca ou nĆ£o tenha mais acesso Ć API Key gerada anteriormente, Ć© possĆvel gerar uma nova diretamente no portal de desenvolvedor da SolarEdge, seguindo os passos abaixo.
Passo 1: Acesse a Ɣrea de Applications
No Dashboard do portal de desenvolvedor, clique em "Applications", no menu superior, destacado em vermelho.
Passo 2: Selecione a aplicaĆ§Ć£o
Na lista de aplicaƧƵes, clique no nome da aplicaĆ§Ć£o correspondente ao cliente (destacada em vermelho) para abrir os detalhes dela.
Passo 3: Gere uma nova API Key
Na aba "Credentials", clique no botĆ£o "Generate / Regenerate API Key" (destacado em vermelho) para gerar uma nova chave.
Passo 4: Confirme a regeneraĆ§Ć£o
SerĆ” exibido um aviso informando que essa aĆ§Ć£o apaga a API Key existente e que integraƧƵes que utilizam a chave atual deixarĆ£o de funcionar. Marque a caixa "I understand this will break existing integrations" e clique em "Regenerate" (destacado em vermelho) para confirmar.
AtenĆ§Ć£o: ao regenerar a API Key, a chave anterior Ć© invalidada imediatamente. Copie a nova chave e atualize a credencial cadastrada na SolarZ o quanto antes, seguindo a Etapa 8 deste tutorial.
Etapa 8: Cadastre a credencial na SolarZ
Para vincular os dados na Solarz procure por āSolarEdge API V2ā
Com a API Key, o usuĆ”rio, a senha e o plano da conta SolarEdge em mĆ£os, acesse a SolarZ e cadastre uma nova credencial preenchendo os campos "Api Key (Chave Api)", "UsuĆ”rio", "Senha" e "Plano da conta SolarEdge" com os dados obtidos no portal de desenvolvedor da SolarEdge. Depois de preencher todos os campos, clique em "Salvar".
Sugerimos que vocĆŖ faƧa a configuraĆ§Ć£o da integraĆ§Ć£o V2 e peƧa a migraĆ§Ć£o ao suporte da solarz o quanto antes para evitar perder a conexĆ£o com o portal.
Pronto! Com a credencial cadastrada na SolarZ, sua aplicaĆ§Ć£o jĆ” estĆ” configurada para realizar chamadas Ć API de Monitoramento da SolarEdge.