Skip to main content
Uma chave pertence ao usuário que a criou e à conta Hubfy em que foi criada. Ela autentica a integração somente nessa conta e carrega as permissões escolhidas. Seu segredo usa o prefixo sk_live_. O cadastro da chave tem um ID ak_..., que identifica a credencial no painel e não substitui o segredo na autenticação.

Criar uma chave

  1. Entre como proprietário da conta.
  2. Abra Meu perfil → API Keys dentro da conta desejada.
  3. Informe um nome, as permissões e, se necessário, a data de expiração.
  4. Copie o segredo completo quando for exibido e armazene-o no servidor da integração.
Cada usuário pode ter até cinco chaves ativas e não expiradas por conta. Consultas posteriores mostram somente os identificadores mascarados; não permitem recuperar o segredo.

Editar ou revogar

O proprietário da conta vê e administra somente as próprias chaves: pode alterar nome, permissões e validade. O segredo não é editável. Revogar é permanente e interrompe a autenticação com aquela chave. Para substituir uma credencial, crie outra chave, atualize sua integração e revogue a anterior depois de verificar a troca. Remover ou desativar o acesso do usuário à conta revoga permanentemente suas chaves nela. Um convite posterior não reativa essas credenciais. Excluir o usuário também interrompe o acesso.

Limite da administração

Uma chave da API não cria, lista, edita ou revoga outras chaves. A administração exige a sessão autenticada do proprietário no painel. Destinos de webhook e histórico de eventos e entregas continuam pertencendo à conta e exigem sessão de proprietário. Por exemplo, Fred cria uma chave na Rocket. Essa chave acessa apenas a Rocket, mesmo que Fred também tenha acesso a outra empresa. Outro proprietário da Rocket não vê nem altera essa chave. Use o segredo somente nas operações públicas e respeite as permissões selecionadas.