Τεκμηρίωση

Μάθε το TicketsX πιο γρήγορα

Οδηγοί ρύθμισης, όλες οι εντολές, οι λειτουργίες Premium και το REST API σε ένα σημείο.

13.20

Ανάκτηση αρχείου σε HTML

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

Κατεβάζει ολόκληρο το αποθηκευμένο αρχείο HTML ενός κλειστού αιτήματος. Είναι ακριβώς το αρχείο που δείχνει ο πίνακας, με όλα τα μηνύματα, τα ενσωματωμένα μηνύματα, τους συνδέσμους των συνημμένων και τις εικόνες προφίλ. Απαιτεί το δικαίωμα `view_transcript_html` (εξαρχής ανενεργό).

Παράμετροι ερωτήματος

ΌνομαΤύποςΥποχρεωτικόΠεριγραφή
formatstring
προαιρετικό
Βάλε raw για να πάρεις το ίδιο το αρχείο HTML με Content-Type: text/html, έτοιμο για αποθήκευση ή για ενσωμάτωση σε iframe. Άσ' το κενό για την προεπιλεγμένη απάντηση JSON, με τα στοιχεία του αρχείου δίπλα στον κώδικα HTML. Τα σφάλματα επιστρέφονται πάντα σε JSON.

Είναι η πιο ευαίσθητη ανάγνωση που προσφέρει το API, οπότε περιορίζεται σε 10 αιτήματα το λεπτό για κάθε διακριτικό και κάθε κλήση γράφεται στο αρχείο ενεργειών του διακομιστή σου. Τα αρχεία συνομιλίας φυλάσσονται κρυπτογραφημένα και αποκρυπτογραφούνται σε κάθε αίτημα. Τα πολύ μεγάλα αρχεία απορρίπτονται με 413, και τότε η απάντηση περιέχει το transcript_url για να τα δεις.

Παράδειγμα αιτήματος: απάντηση JSON
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>/html"
Παράδειγμα αιτήματος: απευθείας αποθήκευση του αρχείου
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"
Παράδειγμα απάντησης (προεπιλεγμένο JSON)
{
  "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>..."
}