Obter o HTML de uma transcrição

GET/<guild_id>/api/transcripts/<ticket_id>/html

Baixa a transcrição HTML completa guardada de um ticket fechado. É exatamente o arquivo que o painel exibe, com cada mensagem, embed, link de anexo e avatar. Exige a permissão `view_transcript_html` (desativada por padrão).

Parâmetros de consulta

Nome	Tipo	Obrigatório	Descrição
format	string	opcional	Use `raw` para receber o próprio arquivo HTML com `Content-Type: text/html`, pronto para gravar em disco ou colocar num iframe. Omita para obter o envelope JSON padrão, com os metadados da transcrição junto ao HTML. Erros são sempre retornados em JSON.

É a leitura mais sensível que a API oferece, então é limitada a 10 requisições por minuto por token, e cada chamada é gravada no registro de atividades do seu servidor. As transcrições ficam guardadas criptografadas e são descriptografadas a cada requisição. Arquivos muito grandes são recusados com 413 e a resposta traz a transcript_url para você ver por lá.

Exemplo de requisição: envelope JSON

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html"

Exemplo de requisição: salvar o arquivo direto

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  -o ticket_42.html \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html?format=raw"

Exemplo de resposta (JSON padrão)

{
  "transcript": {
    "TicketId": 42,
    "PanelId": 1,
    "PanelName": "Support",
    "AuthorId": "123456789",
    "AuthorUsername": "jane",
    "Rating": 5,
    "RatingCount": 1,
    "CloseReason": "Resolved",
    "CreatedAt": 1732200000,
    "ClosedAt": 1732210000,
    "TranscriptUrl": "https://tickets.example.com/<guild_id>/transcripts/42"
  },
  "content_type": "text/html; charset=utf-8",
  "bytes": 184320,
  "html": "<!DOCTYPE html>..."
}