13
Τεκμηρίωση API
Με το REST API του TicketsX συνδέεις δικά σου εργαλεία με το σύστημα αιτημάτων του διακομιστή σου. Δημιουργείς, κλείνεις και χειρίζεσαι αιτήματα μέσα από κώδικα χωρίς το περιβάλλον του Discord, ψάχνεις σε όλο το αρχείο των συνομιλιών και κατεβάζεις το πλήρες κείμενο ή τον κώδικα HTML οποιουδήποτε κλειστού αιτήματος.
Το REST API είναι δυνατότητα Premium. Διακριτικά API δημιουργούνται και χρησιμοποιούνται μόνο όσο ο διακομιστής έχει ενεργή συνδρομή Premium (δες τη σελίδα τιμών). Τα αιτήματα από διακομιστή χωρίς Premium απορρίπτονται με 402 και το πεδίο premium_required: true. Αν λήξει το Premium, τα διακριτικά σου κρατιούνται αλλά σταματούν να δουλεύουν ώσπου να το ενεργοποιήσεις ξανά. Στο μεταξύ μπορείς να τα δεις, να τα απενεργοποιήσεις και να τα ανακαλέσεις από τον πίνακα.
https://api.ticketsx.xyzΚάθε αίτημα χρειάζεται διακριτικό API, που στέλνεται ως διακριτικό Bearer στην κεφαλίδα Authorization. Τα διακριτικά ισχύουν για έναν μόνο διακομιστή και μπορούν να περιοριστούν ανά ενέργεια.
Authorization: Bearer <API_TOKEN>Σε όλες τις διαδρομές παρακάτω, αντικατέστησε το <guild_id> με το αναγνωριστικό του διακομιστή σου στο Discord και το <ticket_id> με το αναγνωριστικό του αιτήματος.
Όλα τα σώματα αιτημάτων POST χρειάζονται Content-Type: application/json. Οι απαντήσεις 4xx περιέχουν το πεδίο JSON error. Το 401 σημαίνει ότι το διακριτικό δεν ισχύει, έληξε ή ανακλήθηκε, το 402 ότι ο διακομιστής δεν έχει Premium (η απάντηση φέρνει και premium_required: true), το 403 ότι το διακριτικό είναι απενεργοποιημένο ή δεν έχει το δικαίωμα που χρειάζεται, και το 429 ότι έπεσες σε όριο (δες την ενότητα Όρια και ασφάλεια) και περιλαμβάνει τιμή retry_after σε δευτερόλεπτα.