O que é um token de API?
Um token de API é uma chave de acesso que permite a autenticação e interação com nossa API. Ele é essencial para que você possa realizar chamadas e integrações programáticas com nossos serviços.
Como criar o token de API via Painel
1. No Painel iugu, acesse a aba de “Configurações” no menu lateral esquerdo, em seguida, selecione a opção “Integração via API” e clique em “Novo”.
*Nessa tela, você verá os status dos Tokens criados, além de poder criar novos.
2. Escolha se o tipo do token será "Teste" ou "Produção", adicione uma descrição que ajude a identificá-lo, e, no caso de end-points que requerem assinatura, cole a chave pública.
3. Depois de inserir todos os dados necessários, clique em “Salvar”.
O token criado ficará com o status “pendente” até que um administrador da conta revise e aprove sua criação.
Atenção: O Token gerado só ficará visível durante 1 hora. Por isso, não se esqueça de copiá-lo e guardá-lo em um ambiente seguro.
Como aprovar um Token de API criado via Painel
Após a criação de um novo token de API via Painel, enviaremos automaticamente um e-mail para todos os usuários com Perfil de Administrador da sua conta. Esse e-mail contem um link para que um administrador possa revisar e aprovar ou não a criação do token.
Para aprovar um dos Administradores da conta deve:
- Clicar no botão "Acesse seu painel" no e-mail recebido (se atente ao remetente para não clicar em e-mails falsos);
- Fazer login com suas credenciais do Painel;
- Clicar em Aprovar ou Rejeitar a criação do token.
Se o token for aprovado, ele será ativado e estará disponível para uso imediato. Porém, caso recusado o token não será criado e não poderá ser utilizado em suas chamadas de API.
Lembrando que, o Token só ficará visível durante uma hora a partir da criação, depois desse período nem mesmo o Administrador poderá visualizá-lo ao aprovar. Por isso, ao criar um novo Token sempre o copie e guarde em um lugar seguro para utilizar mais tarde.
Como é o processo para Tokens de API criados por uma subconta?
Subcontas podem criar Tokens de API tanto pelo Painel quanto pela API. No entanto, é importante observar que tokens criados através do Painel requerem aprovação do administrador da Conta Mestre. Portanto, se você for administrador de uma subconta e criar um novo token pelo Painel, será necessário obter a aprovação do administrador da Conta Mestre. O processo de aprovação está detalhado no tópico anterior.
E se eu não receber o e-mail para aprovação?
Certifique-se de que o e-mail não foi para a caixa de spam ou lixo eletrônico. Se o e-mail não estiver lá, entre em contato com nossa equipe de suporte para verificar se há algum problema com o envio do e-mail.
Como criar o token via API
Para criar um Token via API acesse nossa documentação: Criar API Token (iugu.com)
Esse tipo de Token não necessita de aprovação de um administrador.
0 Comentários