13.20
रिकॉर्ड का HTML लाना
GET
/<guild_id>/api/transcripts/<ticket_id>/htmlबंद टिकट का पूरा सहेजा हुआ HTML रिकॉर्ड डाउनलोड करता है। यह ठीक वही संग्रह है जो डैशबोर्ड दिखाता है, सारे संदेशों, एम्बेड, संलग्नकों के लिंक और तस्वीरों के साथ। इसके लिए `view_transcript_html` अनुमति चाहिए (शुरू में बंद रहती है)।
प्रश्न पैरामीटर
| नाम | प्रकार | ज़रूरी | विवरण |
|---|---|---|---|
| format | string | वैकल्पिक | 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>..."
}