Τεκμηρίωση

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

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

13.15

Αλλαγή πίνακα ενός αιτήματος

POST/<guild_id>/api/tickets/<ticket_id>/switch-panel

Μεταφέρει ένα αίτημα σε άλλον απλό πίνακα. Είναι το αντίστοιχο της εντολής /switchpanel μέσα από το API. Το αίτημα μετονομάζεται σύμφωνα με το μοτίβο του νέου πίνακα, μεταφέρεται στην κατηγορία του (στα αιτήματα που είναι κανάλια) και οι ομάδες υποστήριξης του νέου πίνακα αποκτούν πρόσβαση. Απαιτεί το δικαίωμα `switch_panel` (εξαρχής ανενεργό).

Σώμα αιτήματος

ΌνομαΤύποςΥποχρεωτικόΠεριγραφή
panel_idnumber
υποχρεωτικό
Το αναγνωριστικό του απλού πίνακα στον οποίο μεταφέρεται το αίτημα (δες τη Λίστα πινάκων).
keep_permissionsboolean
προαιρετικό
Κρατά τα υπάρχοντα δικαιώματα ρόλων στο κανάλι, πέρα από τις ομάδες του νέου πίνακα (προεπιλογή true). Βάλε false για να μείνει η πρόσβαση μόνο στις ομάδες υποστήριξης του νέου πίνακα.

Ο τρόπος των αιτημάτων πρέπει να ταιριάζει: τα αιτήματα που είναι κανάλια πάνε μόνο σε πίνακες με κανάλια και τα αιτήματα που είναι νήματα μόνο σε πίνακες με νήματα. Επειδή η αλλαγή μετονομάζει το κανάλι, το Discord την επιτρέπει περίπου δύο φορές ανά 10 λεπτά. Το σημείο πρόσβασης κρατά το ίδιο όριο και επιστρέφει 429 με retry_after όταν το ξεπεράσεις.

Παράδειγμα αιτήματος
curl -X POST \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"panel_id":2,"keep_permissions":true}' \
  https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/switch-panel
Παράδειγμα απάντησης
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}