Skip to main content

Autenticação

Todos os serviços da Pierre Finance (REST API e MCP Server) requerem autenticação via API key.

Obter API Key

1

Acessar o Dashboard

2

Fazer Login

Entre com sua conta Pierre Finance ou crie uma nova conta
3

Gerar API Key

Clique em “Generate API Key” para criar uma nova chave
4

Copiar a Chave

Copie a chave gerada (começa com “sk-”) e guarde-a em local seguro

Formato da API Key

Todas as API keys da Pierre Finance seguem o formato:
Nunca compartilhe sua API key publicamente. A chave dá acesso completo aos seus dados financeiros.

Usando a API Key

REST API

Inclua a API key no header de autorização:
Exemplo com cURL:

MCP Server

Para o servidor MCP, autentique-se de uma das formas abaixo:
  1. Header Authorization
  1. Parâmetro de URL apiKey
Evite inserir esse endereço em navegadores/logs públicos.

Verificação de Assinatura

Além da API key, você precisa ter uma assinatura ativa para acessar os dados financeiros.

Status da Assinatura

  • Ativa: Acesso completo a todos os serviços
  • Cancelada: Acesso até o final do período atual
  • Expirada: Sem acesso aos dados financeiros
Se sua assinatura estiver inativa, você receberá um erro 401 com detalhes sobre o status.

Códigos de Erro

401 - Erro de Autenticação

401 - Sem Assinatura Ativa

401 - Assinatura Cancelada

Segurança

Boas Práticas

  • Nunca compartilhe sua API key publicamente
  • Nunca commite API keys no controle de versão
  • Use variáveis de ambiente para armazenar a chave
  • Rotacione suas chaves regularmente
  • Monitore o uso das suas chaves

Variáveis de Ambiente

Revogar API Key

Se você suspeitar que sua API key foi comprometida:
  1. Acesse https://pierre.finance/api-key
  2. Encontre a chave comprometida
  3. Clique em “Revoke”
  4. Gere uma nova chave
Revogar uma chave é irreversível. Todas as aplicações usando essa chave perderão acesso imediatamente.

Suporte

Se você tiver problemas com autenticação: