Ταυτοποίηση

Τα διακριτικά API δημιουργούνται και διαχειρίζονται από την πλαϊνή στήλη του διακομιστή στον πίνακα του TicketsX. Κάθε διακριτικό ανήκει σε έναν διακομιστή, και για να δημιουργηθεί ή να χρησιμοποιηθεί ο διακομιστής χρειάζεται ενεργή συνδρομή Premium.

Δημιουργία διακριτικού

Ενεργοποίησε το Premium για τον διακομιστή από τη σελίδα Premium (η σελίδα Πρόσβαση API οδηγεί κατευθείαν εκεί).
Άνοιξε την πλαϊνή στήλη του διακομιστή και πήγαινε στην Πρόσβαση API.
Δώσε όνομα στο διακριτικό (για παράδειγμα "Bot υποστήριξης" ή "Σύνδεση CRM").
Πάτησε Δημιουργία διακριτικού και αντίγραψε την τιμή που εμφανίζεται.
Φύλαξέ την σε ασφαλή αποθήκη μυστικών· μόλις κλείσεις το μήνυμα δεν την ξαναβλέπεις.

Αν λήξει το Premium

Τα διακριτικά σου δεν σβήνονται. Κάθε αίτημα στο API αρχίζει να επιστρέφει 402 με premium_required: true, και η δημιουργία ή αντικατάσταση διακριτικών μπλοκάρεται ώσπου να ενεργοποιηθεί ξανά η συνδρομή. Η προβολή, η απενεργοποίηση και η ανάκληση των διακριτικών συνεχίζουν να δουλεύουν, ώστε να μπορείς να τακτοποιήσεις τα πράγματα. Στη δική σου ενσωμάτωση χειρίσου το 402 όπως το 401: σταμάτα τις επαναλήψεις και ειδοποίησε έναν άνθρωπο.

Η απάντηση όταν ο διακομιστής δεν έχει Premium

{
  "error": "The TicketsX REST API is a Premium feature. Activate Premium for this server to use API tokens.",
  "premium_required": true
}

Η ανάκληση ενός διακριτικού το ακυρώνει αμέσως σε όλα τα σημεία πρόσβασης. Αν δεν αντέχεις διακοπή, φτιάξε πρώτα το διακριτικό που θα το αντικαταστήσει.

Χρήση διακριτικού

Στείλε το διακριτικό ως κεφαλίδα Bearer σε κάθε αίτημα. Όλα τα αιτήματα ισχύουν μόνο για τον διακομιστή στον οποίο δημιουργήθηκε το διακριτικό.

Παράδειγμα ταυτοποιημένου αιτήματος

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  https://api.ticketsx.xyz/<guild_id>/api/tickets