Chaves de API
Uma chave de API deixa outro sistema (o da administradora, um ERP) cadastrar e atualizar unidades votantes pela API, sem usar a sua senha. Cada chave age em seu nome e vale para os seus condomínios. O cartão Chaves de API fica em Minha conta → Integrações.
Criar uma chave
Seção intitulada “Criar uma chave”- Em Minha conta, aba Integrações, no cartão Chaves de API, clique em Nova chave.
- Dê um Nome que identifique quem vai usar a chave (“Sistema da administradora”) e clique em Criar chave.
- Em Chave criada, clique em Copiar e entregue a chave ao integrador por um canal seguro. Esta chave não será exibida novamente. Clique em Já copiei a chave.
A chave começa com va_. O integrador a envia em cada chamada à API, no cabeçalho Authorization: Bearer va_… (ou X-Api-Key), como diz a tela. A lista mostra o Nome, o Prefixo (os primeiros caracteres, para reconhecer a chave), a data de criação e o Último uso (Nunca usada até a primeira chamada). O limite é de 10 chaves por conta.
Revogar
Seção intitulada “Revogar”Na linha da chave, clique em Revogar e confirme: os sistemas que usam esta chave perdem o acesso imediatamente, e não dá para desfazer. Crie outra se precisar.
Para o integrador
Seção intitulada “Para o integrador”O que a API faz e onde está a documentação técnica (o link Documentação da API do cartão): veja API de integração.
Veja também
Seção intitulada “Veja também”Ainda com dúvida?
Mande a sua pergunta pelo formulário do painel ou por e-mail. Conte o que aparece na tela e onde: no painel, no aplicativo ou no site de votação. A resposta chega por e-mail.