Skip to main content

​
🔐Como funciona o campo authorization na nossa API.

A nossa API usa Basic Access Authentication. Traduzindo: você autentica enviando sua chave secreta codificada em Base64, dentro do header HTTP chamado authorization.

​
🤔 O que isso significa na prática?

Basic <base64(username:password)>
No nosso caso:
  • username → é a sua chave secreta (SECRET_KEY)
  • password → é sempre “x”
    • Não é usado para nada, mas precisa existir por padrão do Basic Auth.
Ou seja, você precisa montar a string: SECRET_KEY:x E depois converter isso para Base64.

​
🧠 Exemplo real explicado passo a passo

Configurações → Credenciais de API → Chave secreta
  1. Monte a string assim:
minha_chave_secreta_aqui:x
  1. Converta para base64:
bWluaGFfY2hhdmVfc2VjcmV0YV9hcXVpOng=
  1. Envie no header:
authorization: Basic bWluaGFfY2hhdmVfc2VjcmV0YV9hcXVpOng=

​
🟧 Exemplo em Node.js atualizado

const options = {
  method: "POST",
  url: "https://api.conta.paybeehive.com.br/v1/transactions",
  headers: {
    authorization: "Basic " + Buffer.from(`${SECRET_KEY}:x`).toString("base64"),
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    /* payload da transação */
  })
};

​
Onde pegar sua chave secreta 🧭

No painel da Beehive:  Configurações → Credenciais de API Ali você verá:
  • 🔑 Chave secreta
  • 🔓 Chave pública (para uso client-side, não serve para autenticar na API)
  • ⏳ Prazo de expiração da chave
A chave secreta é a que você deve usar no Basic Auth.