Documentation

Prends TicketsX en main plus vite

Guides d'installation, référence complète des commandes, fonctionnalités Premium et API REST au même endroit.

13.20

Récupérer le HTML d'une transcription

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

Télécharge la transcription HTML complète enregistrée pour un ticket fermé. C'est exactement l'archive affichée par le tableau de bord, avec chaque message, chaque embed, chaque lien de pièce jointe et chaque avatar. Nécessite la permission `view_transcript_html` (désactivée par défaut).

Paramètres de requête

NomTypeObligatoireDescription
formatstring
facultatif
Mets raw pour recevoir le fichier HTML lui-même avec Content-Type: text/html, prêt à enregistrer sur disque ou à placer dans un iframe. Omets-le pour obtenir l'enveloppe JSON par défaut, avec les métadonnées de la transcription à côté du HTML. Les erreurs sont toujours renvoyées en JSON.

C'est la lecture la plus sensible que propose l'API : elle est donc limitée à 10 requêtes par minute et par jeton, et chaque appel est inscrit au journal d'activité de ton serveur. Les transcriptions sont stockées chiffrées et déchiffrées à chaque requête. Les archives très volumineuses sont refusées avec 413, la réponse contenant alors la transcript_url à consulter à la place.

Exemple de requête : enveloppe JSON
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html"
Exemple de requête : enregistrer le fichier directement
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"
Exemple de réponse (JSON par défaut)
{
  "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>..."
}