13
API-leírás
A TicketsX REST API-jával külső eszközöket kötsz össze a szervered jegyrendszerével. Kódból hozol létre, zársz le és kezelsz jegyeket a Discord felülete nélkül, keresel a teljes átirat-archívumban, és lekéred bármelyik lezárt jegy teljes szövegét vagy HTML-jét.
A REST API prémium funkció. API-kulcsot csak akkor lehet létrehozni és használni, amíg a szervernek él a Prémium előfizetése (lásd az árak oldalt). A Prémium nélküli szerverek kéréseit 402 válasszal és a premium_required: true mezővel utasítjuk el. Ha a Prémium lejár, a kulcsaid megmaradnak, de nem működnek, amíg újra be nem kapcsolod. Addig is kilistázhatod, kikapcsolhatod és visszavonhatod őket a vezérlőpulton.
https://api.ticketsx.xyzMinden kéréshez API-kulcs kell, amelyet Bearer kulcsként küldesz az Authorization fejlécben. A kulcsok egyetlen szerverhez tartoznak, és műveletenként külön korlátozhatók.
Authorization: Bearer <API_TOKEN>Az alábbi útvonalakban cseréld a <guild_id> részt a Discord-szervered azonosítójára, a <ticket_id> részt pedig az érintett jegy azonosítójára.
Minden POST kérés törzséhez Content-Type: application/json kell. A 4xx válaszok tartalmazzák az error JSON-mezőt; a 401 azt jelenti, hogy a kulcs érvénytelen, lejárt vagy visszavonták; a 402 azt, hogy a szervernek nincs Prémiuma (a válaszban ott van a premium_required: true is); a 403 azt, hogy a kulcs ki van kapcsolva, vagy hiányzik a szükséges jogosultsága; a 429 pedig azt, hogy korlátba ütköztél (lásd a Korlátok és biztonság részt), és retry_after értéket tartalmaz másodpercben.