Autenticação

Toda requisição precisa da sua chave de API no header Authorization, no formato Bearer. Não há login, token de sessão nem refresh: a chave é a credencial completa.

curl https://novexfinance.com.br/api/v1/ping \
  -H "Authorization: Bearer nvx_live_a1b2c3d4e5f6…"

$ch = curl_init('https://novexfinance.com.br/api/v1/ping');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('NOVEX_API_KEY'),
        'Content-Type: application/json',
    ],
]);
$body = json_decode(curl_exec($ch), true);

const res = await fetch('https://novexfinance.com.br/api/v1/ping', {
  headers: {
    'Authorization': `Bearer ${process.env.NOVEX_API_KEY}`,
    'Content-Type': 'application/json',
  },
});

const data = await res.json();

import os, requests

res = requests.get(
    'https://novexfinance.com.br/api/v1/ping',
    headers={'Authorization': f'Bearer {os.environ["NOVEX_API_KEY"]}'},
    timeout=30,
)
data = res.json()

{
  "object": "ping",
  "authenticated": true,
  "account_id": "acct_42",
  "server_time": "2026-08-07T14:32:10-03:00",
  "api_version": "v1"
}

Gerar uma chave

1. Entre no painel

   Acesse Configurações → API Keys com a sua conta Novex.

2. Gere a chave

   Dê um nome que identifique onde ela vai ser usada — loja-producao, erp-interno. Se um dia precisar revogar, você saberá exatamente o que vai parar.

3. Copie na hora

   A chave aparece uma única vez. Guardamos apenas um hash dela — nem nós conseguimos recuperá-la depois. Se perder, revogue e gere outra.

As chaves começam com nvx_live_ e têm 57 caracteres:

# exemplo do formato (esta chave não é válida)
nvx_live_7d3f9a21c48e6b05d7f1a93c2e84b60d5a71f39c8e04b2d6

Como guardar a chave

Faça:

• Guarde em variável de ambiente ou cofre de segredos.
• Chame a API sempre do seu servidor.
• Use uma chave por aplicação, para poder revogar uma sem derrubar as outras.
• Revogue imediatamente qualquer chave que tenha vazado.

Nunca faça:

• Colocar a chave em JavaScript, aplicativo móvel ou qualquer código que roda no dispositivo do cliente — lá ela é pública, por definição.
• Versionar em Git, mesmo em repositório privado.
• Enviar por e-mail, chat ou ticket de suporte. Nossa equipe nunca vai pedir a sua chave.

Revogar

Em API Keys, clique em Revogar. O efeito é imediato: a próxima requisição com aquela chave recebe 401 com revoked_api_key. Revogar não afeta cobranças já criadas — elas seguem o curso normal.

Erros de autenticação