Token da API
Envie o token em toda chamada, no cabeçalho Authorization:
curl "https://app.oportunidados.com.br/api/v1/brazilian_companies/12345678000190/company" \
-H "Authorization: Bearer $OPORTUNIDADOS_API_TOKEN"O token vale para a conta inteira e usa a cota do plano. Não coloque o token na URL: endereços ficam registrados em logs.
Validades
Na criação, em Validade do Token, você escolhe uma destas: 1 dia, 1 semana, 1 mês (o padrão), 6 meses, 1 ano ou Nunca expira. Prefira uma data de expiração e crie o token novo antes dela.
Quem cria e vê os tokens
- Qualquer usuário da conta cria e gerencia os próprios tokens.
- Quem tem acesso a pagamento vê e gerencia os tokens de todos os usuários.
- Crie um token por ambiente ou integração, como Produção e Testes. Assim você desativa um sem parar os outros.
Desativar, ativar e remover
Em Tokens da API, o menu Ações de cada token tem Desativar (ou Ativar, se ele estiver inativo) e Remover. Remover não tem volta.
Se o token vazou, desative-o, crie outro e troque nas suas integrações. Não compartilhe o token por e-mail, chat nem código público.
Respostas de autenticação
Essas recusas acontecem antes da cota e não consomem chamada.
401: token ausente ou inválido
Sem o cabeçalho Authorization:
{"error": "Unauthorized", "message": "Missing authentication token"}Com um token que não existe, venceu ou foi desativado:
{"error": "Unauthorized", "message": "Invalid or expired token"}Confira se copiou o token inteiro. Se ele venceu ou foi desativado, crie outro em Tokens da API.
403: conta sem acesso
Quando a conta não tem assinatura ativa ou está com pagamento em atraso:
{"error": "Forbidden", "message": "Account is not active or payment is overdue"}O token continua o mesmo. A chamada volta a funcionar com o pagamento confirmado.
Se uma fatura passar de 15 dias em atraso, a assinatura é suspensa e os bônus são anulados. Com a fatura mais recente em aberto, a plataforma e a API deixam de funcionar. Pague a fatura para voltar a usar: o acesso volta quando o pagamento é confirmado.
MCP: login da conta, sem token
O MCP não usa o token da API. Na primeira conexão, o assistente de IA abre a tela de autorização da Oportunidados, você entra com a sua conta e escolhe as permissões. Nunca coloque token ou senha na URL do conector. Os passos de cada assistente estão em MCP.