Autentikasi

Token API dibuat dan dikelola lewat bilah samping server di dasbor TicketsX. Tiap token terikat pada satu server, dan untuk membuat atau memakainya server harus punya langganan Premium yang aktif.

Membuat token

Aktifkan Premium untuk server lewat halaman Premium (halaman Akses API menautkannya langsung).
Buka bilah samping server lalu masuk ke Akses API.
Beri nama tokennya (misalnya "Bot Dukungan" atau "Sinkronisasi CRM").
Klik Buat Token lalu salin nilai yang ditampilkan.
Simpan di brankas rahasia; setelah pemberitahuannya ditutup, nilainya tidak bisa dilihat lagi.

Kalau Premium berhenti

Token Anda tidak dihapus. Semua permintaan API mulai mengembalikan 402 beserta premium_required: true, dan pembuatan maupun penggantian token diblokir sampai langganan aktif lagi. Melihat daftar, mematikan, dan mencabut token tetap berjalan, jadi Anda tetap bisa berbenah. Perlakukan 402 di integrasi Anda seperti 401: hentikan percobaan ulang dan beri tahu orang.

Respons ketika server tidak punya Premium

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

Mencabut token langsung membuatnya tidak berlaku di semua endpoint. Kalau Anda tidak ingin ada jeda, buat penggantinya lebih dulu.

Memakai token

Kirim token sebagai header Bearer pada setiap permintaan. Semua permintaan hanya berlaku untuk server tempat token itu dibuat.

Contoh permintaan terautentikasi

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