Documentação

API do Termynal

Envie HTML de transcript e metadados do bot. Apenas o token `Bearer` correto pode criar novas transcrições.

POST /api/transcripts

Envie o HTML do transcript e crie a transcrição protegida.

Este endpoint gera um ID seguro, uma senha amigável e a URL privada para visualização do transcript.

Autenticação

Authorization: Bearer <TOKEN>

Segurança

Somente o bot com token válido pode usar este endpoint.

Sem token correto, a API retorna 401. O acesso ao transcript é protegido por senha e sessão de curta duração.

Resposta

{
  "id": "tr_...",
  "password": "forest-orange-932",
  "url": "https://seu-host/t/tr_..."
}

Como usar

Envie o payload JSON com HTML e metadados do seu bot. A API valida o token e responde com o link privado e a senha.

Headers

Authorization: Bearer <TOKEN>
Content-Type: application/json

Resposta

{
  "id": "tr_...",
  "password": "forest-orange-932",
  "url": "https://seu-host/t/tr_..."
}

Exemplo curl

curl -X POST https://yourhost/api/transcripts   -H "Authorization: Bearer $API_BEARER_TOKEN"   -H "Content-Type: application/json"   -d '{
    "html": "<html>...</html>",
    "guildId": "1234567890",
    "guildName": "Minha Guild",
    "ticketId": "987654",
    "ticketName": "ticket-001",
    "createdBy": "bot",
    "closedBy": "admin",
    "participants": ["usuario1", "usuario2"]
  }'

Fluxo de acesso

  1. O bot envia o transcript para a API usando o token.
  2. O serviço cria o registro protegido e retorna o link e a senha.
  3. O usuário abre o link, digita a senha e recebe o cookie de sessão.
  4. O viewer carrega o transcript e mantém o acesso por alguns minutos.