Pular para o conteúdo principal

Visão Geral

A API KillB usa JWT (JSON Web Tokens) para autenticação. Todas as requisições da API devem incluir um token de acesso válido no cabeçalho Authorization.
A autenticação da API usa uma combinação de login email/senha e chaves API para diferentes padrões de acesso.

Métodos de Autenticação

Usado para a maioria das operações da API. Obtido via endpoint de login.Melhor para: Aplicações web e mobile, operações específicas do usuário

Obtendo Suas Credenciais

  1. Cadastre-se na KillB em killb.com
  2. Acesse o Dashboard em otc.killb.com
  3. Obtenha Credenciais:
    • Seu email de login e senha
    • Sua chave API nas configurações do dashboard

Fluxo de Login

Passo 1: Gerar Token de Acesso

POST /api/v2/auth/login
Requisição:
{
  "email": "[email protected]",
  "password": "sua-senha"
}
Resposta:
{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 3600000,
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Passo 2: Usar Token de Acesso

Inclua o token de acesso no cabeçalho Authorization para todas as requisições da API:
Authorization: Bearer SEU_ACCESS_TOKEN

Atualizar Tokens

Tokens de acesso expiram após 1 hora. Use o token de refresh para obter um novo token de acesso:
POST /api/v2/auth/refresh
Implemente atualização automática de tokens na sua aplicação para manter acesso ininterrupto à API.

Melhores Práticas de Segurança

  • Nunca faça commit de credenciais no controle de versão
  • Use variáveis de ambiente para chaves API e tokens
  • Rotacione chaves API regularmente
  • Use serviços de gerenciamento de secrets
  • Armazene tokens com segurança
  • Implemente atualização automática de tokens
  • Limpe tokens ao fazer logout
  • Defina tempos de expiração apropriados
  • Sempre use HTTPS para requisições da API
  • Implemente certificate pinning para apps mobile
  • Valide certificados SSL
  • Use conexões de rede seguras

Próximos Passos