Autenticação

A API LinkPix utiliza autenticação via Bearer Token. Todas as requisições devem incluir o header Authorization com sua chave de API.

Formato da API Key

As chaves de API seguem o padrão:

Obtendo suas Chaves

Formato do Header

Inclua o header Authorization em todas as requisições:

Authorization: Bearer mbx_live_sua_chave_aqui
Content-Type: application/json

Exemplos de Autenticação

curl -X GET http://app.linkpix.co/api/v1/clients \
  -H "Authorization: Bearer mbx_live_sua_chave_aqui" \
  -H "Content-Type: application/json"

const apiKey = process.env.LINKPIX_API_KEY;

const response = await fetch('http://app.linkpix.co/api/v1/clients', {
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  }
});

const data = await response.json();

import os
import requests

api_key = os.environ.get('LINKPIX_API_KEY')

headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

response = requests.get(
    'http://app.linkpix.co/api/v1/clients',
    headers=headers
)

data = response.json()

Gerenciamento de Chaves

Listando Chaves

No painel de API Keys você pode ver:

• Prefixo da chave: Primeiros caracteres para identificação
• Data de criação: Quando a chave foi gerada
• Último uso: Última vez que a chave foi utilizada

Revogando Chaves

Para revogar uma chave:

1. Acesse Configurações → Desenvolvedor
2. Localize a chave pelo prefixo
3. Clique no ícone de deletar
4. Confirme a ação

Erros de Autenticação

Boas Práticas de Segurança

✅ Faça

• Armazene chaves em variáveis de ambiente
• Use secrets managers em produção
• Rotacione chaves periodicamente
• Monitore o uso das chaves no painel

❌ Não Faça

• Commitar chaves em repositórios Git
• Expor chaves em código front-end
• Compartilhar chaves entre equipes diferentes
• Ignorar alertas de uso suspeito

Testando a Autenticação

Verifique se sua chave está funcionando:

curl -X GET http://app.linkpix.co/api/v1/me \
  -H "Authorization: Bearer sua_chave_aqui"

Resposta de sucesso:

{
  "data": {
    "team": {
      "id": "uuid",
      "name": "Minha Empresa"
    },
    "test_mode": false
  }
}