दस्तावेज़

TicketsX जल्दी सीखें

सेटअप की गाइड, सारी कमांड, Premium की सुविधाएँ और REST API, सब एक जगह।

13.18

रिकॉर्ड लाना

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

टिकट संख्या से बंद टिकट का पूरा रिकॉर्ड लाता है: सारी जानकारी (खोलने वाला, पैनल, रेटिंग, बंद करने का कारण, ज़िम्मा लेने वाले, समय), हर संदेश समय के क्रम में, और हर शामिल व्यक्ति के संदेशों के आँकड़े। टिकट पहले **रिकॉर्ड में खोज** से ढूँढ़ें, या बना-बनाया संग्रह **रिकॉर्ड का HTML लाना** से लें। इसके लिए `view_transcripts` अनुमति चाहिए (शुरू में बंद रहती है)।

प्रश्न पैरामीटर

नामप्रकारज़रूरीविवरण
limitnumber
वैकल्पिक
हर पन्ने पर संदेशों की संख्या, 1-1000 (तयशुदा 500)।
offsetnumber
वैकल्पिक
पन्ने बाँटने के लिए छोड़े जाने वाले संदेशों की संख्या (तयशुदा 0)।

messages और participants की सामग्री रिकॉर्ड अनुक्रमणिका से आती है, जो सर्वर पर Premium रहते बनती है और पहली बार Premium लेने पर आपके पुराने संग्रह पर भी चढ़ा दी जाती है। Premium लेने से पहले (या पुराने संग्रह की अनुक्रमणिका बनते समय) बंद हुआ टिकट indexed: false और ख़ाली messages सूची के साथ लौटता है। ऐसे टिकटों के लिए रिकॉर्ड का HTML लाना या transcript.TranscriptUrl इस्तेमाल करें। लंबे टिकट pagination वस्तु से पन्ना दर पन्ना देखें।

अनुरोध का उदाहरण
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>?limit=500"
जवाब का उदाहरण
{
  "transcript": {
    "TicketId": 42,
    "PanelId": 1,
    "PanelName": "Support",
    "AuthorId": "123456789",
    "AuthorUsername": "jane",
    "Rating": 5,
    "RatingCount": 1,
    "CloseReason": "Resolved",
    "CreatedAt": 1732200000,
    "ClosedAt": 1732210000,
    "ClosedBy": "987654321",
    "ClaimedIds": ["987654321"],
    "TranscriptUrl": "https://tickets.example.com/<guild_id>/transcripts/42"
  },
  "indexed": true,
  "messages": [
    { "MessageId": "111", "AuthorId": "123456789", "AuthorUsername": "jane", "IsBot": false, "Content": "My login is broken", "CreatedAt": 1732200050 },
    { "MessageId": "112", "AuthorId": "987654321", "AuthorUsername": "staff", "IsBot": false, "Content": "Looking into it now!", "CreatedAt": 1732200110 }
  ],
  "participants": [
    { "UserId": "123456789", "Username": "jane", "IsBot": false, "MessageCount": 12, "FirstMessageAt": 1732200050, "LastMessageAt": 1732209900 }
  ],
  "pagination": { "total": 2, "limit": 500, "offset": 0, "returned": 2 }
}