การดึงบันทึกสนทนาเป็น 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>..."
}