Kimlik doğrulama

API jetonları TicketsX panelinde sunucu yan menüsünden oluşturulur ve yönetilir. Her jeton tek bir sunucuya bağlıdır ve jeton oluşturmak veya kullanmak için sunucunun etkin bir Premium aboneliği gerekir.

Jeton oluşturma

Sunucunun Premium'unu Premium sayfasından etkinleştirin (API Erişimi sayfası doğrudan oraya bağlanır).
Sunucu yan menüsünü açıp API Erişimi bölümüne gidin.
Jetona bir ad verin (örneğin "Destek Botu" veya "CRM Aktarımı").
Jeton oluştur düğmesine basıp görünen değeri kopyalayın.
Bir sır kasasında saklayın; bildirimi kapattıktan sonra bir daha göremezsiniz.

Premium biterse

Jetonlarınız silinmez. Abonelik yeniden etkinleşene kadar her API isteği 402 ve premium_required: true döndürmeye başlar, jeton oluşturma ve yenileme de engellenir. Jetonları listeleme, kapatma ve iptal etme çalışmaya devam eder, böylece her durumda düzen kurabilirsiniz. Tümleştirmenizde 402 yanıtını 401 gibi ele alın: yeniden denemeyi bırakın ve bir insana haber verin.

Sunucunun Premium'u yokken gelen yanıt

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

Bir jetonu iptal etmek onu bütün uç noktalarda anında geçersiz kılar. Kesinti istemiyorsanız önce yerine geçecek jetonu oluşturun.

Jeton kullanma

Jetonu her istekte Bearer başlığıyla gönderin. Bütün istekler yalnızca jetonun oluşturulduğu sunucu için geçerlidir.

Kimliği doğrulanmış istek örneği

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