Premium¶

TEBHOS'un üç ücretli ürünü vardır; hepsi Polar üzerinden satılır (bkz. Faturalandırma):

• TEBHOS Pro — kişisel bir abonelik (aylık veya yıllık). Pro üyeler mavi bir rozet gösterir ve toplamda 10 ücretsiz sunucu takviyesi dahil Pro ayrıcalıklarından yararlanır.
• Sunucu takviyeleri — bir sunucunun takviye seviyesini yükseltir. Her takviye 30 gün sürer.
• Business Class (İş Sınıfı) — sunucu sahibinin satın aldığı, sunucu başına bir abonelik. Sunucu sarı bir rozet ve seviye 2 takviye ayrıcalıkları kazanır; sahibi ise Pro ayrıcalıklarından yararlanır.

Kozmetik mağazası bu sayfanın sonunda anlatılır. Hediye kodları için bkz. Hediyeler.

Bu sayfadaki her yol bir kullanıcı oturumu gerektirir; bot token'ları 403 ACCESS_DENIED ile reddedilir.

Premium türleri¶

Premium, tür 3 olduğunda ya da tür 1 veya 2 olup premiumUntil gelecekte olduğunda etkindir. Etkin bir İş Sınıfı aboneliği olan sunucunun sahibi, Pro aboneliği olmasa bile bu abonelik bitene kadar premium (tür 1, Monthly) olarak bildirilir.

Premium durum nesnesi¶

Premium durumumu al ve Premium'u iptal et tarafından döndürülür. Alan adları camelCase kullanır.

Örnek¶

{
  "premiumType": 1,
  "premiumTypeName": "Monthly",
  "isPremium": true,
  "premiumSince": "2026-09-01T10:00:00Z",
  "premiumUntil": "2026-10-01T10:00:00Z",
  "daysRemaining": 8,
  "premiumDays": 30,
  "premiumWillCancel": false,
  "has_billing_account": true
}

Premium durumumu al¶

GET /premium/me

Çağıranın premium durum nesnesini ve ek olarak şunu döndürür:

Premium durumunu al¶

GET /premium/state

Çağıranın premium durumunu iç içe geçmiş {actual, effective, billing, pricing} biçiminde döndürür. Yalnızca birkaç alan TEBHOS verisi taşır:

Kullanıcıların rozetlerini denetle¶

POST /premium/check

Verilen kullanıcılardan hangilerinin premium (mavi) veya İş Sınıfı (sarı) rozeti gösterdiğini ve bağlılık rozetlerini çözümler. Kimliği doğrulanmış her kullanıcı çağırabilir.

JSON gövdesi¶

Yanıt¶

{
  "premium_ids": ["1501314428688998182"],
  "business_ids": [],
  "affiliation_badges": []
}

Sunucu takviyeleri¶

Bir sunucunun takviye seviyesi, şu anda ona sayılan takviye sayısından gelir:

Seviye 2 en yüksek seviyedir ve bir sunucunun Keşif içinde görünmesi için gereklidir. Aynı anda bir sunucuya en fazla 25 takviye sayılır; fazladan takviyeler beklemede olarak bekler ve bir yer açıldığında 30 günlük dönemlerine başlar. Bekleyen takviyeler, takviye yapanın kendi rozet kademeleri için yine de sayılır.

Etkin İş Sınıfı olan bir sunucunun etkin seviyesi en az 2'dir.

TEBHOS Pro üyelerinin toplamda 10 ücretsiz takviyesi vardır (ay başına değil). Süresi dolan veya kaldırılan bir takviye ücretsiz takviyeyi geri vermez. Ücretsiz hakkı aşan takviyeler ve Pro olmayan kullanıcıların tüm takviyeleri, tanesi 49,99 TL (2,99 USD) olmak üzere Polar üzerinden ödenir.

Takviye durumumu al¶

GET /users/@me/boost-status

Çağıranın tüm sunuculardaki takviye özetini döndürür (camelCase):

Sunucu takviyelerini al¶

GET /servers/{guild_id}/boost

Bir sunucunun takviye durumunu döndürür. Okuma işlemi ayrıca bekleyen takviyeleri boş yerlere yükseltir.

Sunucuya takviye yap¶

POST /servers/{guild_id}/boost

Bir sunucuya takviye yapar. Ücretsiz takviyeler hemen uygulanır; ücretli kalan kısım tek bir Polar ödeme işleminde tahsil edilir.

JSON gövdesi¶

Gövde isteğe bağlıdır.

Yanıt¶

İstenen tüm takviyeler ücretsiz takviyelerle karşılandığında yol 201 döndürür:

{
  "id": "1501314428688998190",
  "message": "...",
  "free": true,
  "applied": 1,
  "priceMinor": 0,
  "currency": "TRY",
  "freeBoostRemaining": 9
}

Ödeme gerektiğinde bir ödeme URL'siyle 200 döndürür. Ücretli takviyeler Polar ödemeyi onayladıktan sonra uygulanır; tarayıcı sunucunun takviye sayfasına döner.

{
  "paymentRequired": true,
  "url": "https://checkout.example.com/polar_c_1a2b3c",
  "freeApplied": 3,
  "paidCount": 7,
  "priceMinor": 34993,
  "unitPriceMinor": 4999,
  "currency": "TRY",
  "freeBoostRemaining": 0
}

Takviyelerin uygulanması sunucuyu Keşif için yeniden dizinler ve bir Guild Update gönderir.

Takviyelerimi kaldır¶

DELETE /servers/{guild_id}/boost

Çağıranın sunucudaki tüm takviyelerini kaldırır ve {"message": "..."} döndürür. Bunlarda kullanılan ücretsiz takviyeler geri verilmez. Sunucu yeniden dizinlenir ve bir Guild Update gönderilir.

Takviye yapanları listele¶

GET /servers/{guild_id}/boost/boosters

Sunucuya takviye yapanları, en eskiden başlayarak ve kullanıcı başına gruplanmış olarak döndürür:

[
  {
    "profileId": "1501314428688998182",
    "name": "example",
    "imageUrl": "",
    "boostCount": 3,
    "boostedAt": "2026-09-01T10:00:00Z"
  }
]

İş Sınıfı¶

İş Sınıfı (Business Class), tek bir sunucuya bağlı ve sunucunun sahibi tarafından İş Sınıfı ödemesi oluştur üzerinden satın alınan bir aboneliktir. Etkin olduğu sürece:

• sunucu BUSINESS_CLASS sunucu özelliğine sahiptir ve sarı bir rozet gösterir,
• sunucu seviye 2 takviye ayrıcalıkları kazanır (etkin takviye seviyesi en az 2'dir),
• sahip bir TEBHOS Pro üyesi olarak değerlendirilir,
• sahip, bağlılıklar ile en fazla 25 üyeyi sunucuya bağlayabilir,
• herkes Keşif sunucusuna katıl üzerinden sunucuya katılabilir.

Yalnızca sahibe açık yollar, sunucu sahibi olmayan herkese 404 NOT_FOUND ile yanıt verir; böylece sunucunun var olup olmadığını açığa çıkarmaz.

İş Sınıfı abonelik nesnesi¶

İş Sınıfı genel görünümümü al¶

GET /business/me

Çağıranın sahibi olduğu her sunucuyu İş Sınıfı durumuyla birlikte listeler:

{
  "guilds": [
    {
      "guild_id": "1489002177550843904",
      "name": "Example guild",
      "icon_hash": null,
      "business": null,
      "business_active": false
    }
  ],
  "has_live": false
}

business bir abonelik nesnesi veya null'dır.

Sunucunun İş Sınıfını al¶

GET /business/guilds/{guild_id}

Yalnızca sahip. {"business": <subscription object or null>, "business_active": <bool>} döndürür.

İş Sınıfı keşif listelemesini ayarla¶

PUT /business/guilds/{guild_id}/discovery

Yalnızca sahip. Gövde {"enabled": true} veya {"enabled": false}. {"discovery_opt_in": <bool>} döndürür. Abonelik tek başına sunucuyu listelemez; bu katılım tercihi gereklidir.

İş Sınıfı sunucularını listele¶

GET /business/discovery

Keşfe katılmayı seçmiş geçerli İş Sınıfı sunucularını döndürür:

İş Sınıfı bağlılıkları¶

Bir bağlılık, bir sunucu üyesini bir İş Sınıfı sunucusuna bağlar; üye daha sonra sunucunun logosunu adının yanında gösterebilir. Sahip bir istek gönderir, üye kabul eder veya reddeder.

Bağlılık durumları pending, accepted ve inactive şeklindedir. Bir sunucu, inactive olmayan en fazla 25 bağlılık tutabilir. İstek gönderme, kullanıcı başına saatte 30 ile sınırlıdır (business:affiliate kovası).

Mağaza¶

Mağaza profil kozmetikleri satar. Satın almalar bir Polar ödeme işleminden geçer; öğe ödemeden sonra envantere eklenir.

Kozmetik yuvaları¶

Mağaza koleksiyonlarını listele¶

GET /shop/collections

{collections, items, bundles} döndürür. Öğelerde id, slug, collection_id, name, description, item_type (bir yuva), price, premium_price, asset_data ve purchasable bulunur; paketlerde id, slug, collection_id, name, description, price, premium_price, item_ids ve purchasable bulunur. Öğe için yapılandırılmış bir Polar ürünü yoksa purchasable değeri false olur.

Envanteri al¶

GET /shop/inventory

Çağıran için {"entries": [{id, item_id, source, bundle_id, purchased_at}]} döndürür.

Kuşanılan kozmetikleri al¶

GET /shop/equipped

Çağıranın her yuvada kuşandığı öğeyi {name_plate, avatar_decoration, profile_effect, avatar_hat, app_logo} olarak döndürür (her biri bir öğe veya null). {"profile_ids": [...]} ile POST /shop/equipped/bulk, aynısını birkaç kullanıcı için kullanıcı kimliğine göre anahtarlanmış olarak döndürür.

Mağaza öğesi satın al¶

POST /shop/items/{item_id}/purchase

Tek bir öğe için Polar ödeme işlemi açar ve bir yönlendirme URL nesnesi döndürür.

Alıcı (veya hediye alıcısı) öğeye zaten sahipse, alıcı çağıranın kendisiyse ya da öğe satın alınamıyorsa 400; öğe veya alıcı yoksa 404 döndürür.

Mağaza paketi satın al¶

POST /shop/bundles/{bundle_id}/purchase

Bir paket için Mağaza öğesi satın al ile aynıdır.

Kozmetik kuşan¶

PATCH /shop/equipped/{slot}

Gövde {"item_id": "<item uuid>"} bir öğeyi yuvaya kuşandırır; {"item_id": null} yuvayı temizler. Öğe türü yuvayla eşleşmelidir. Çağıranın öğeye sahip olması gerekir; yalnızca TEBHOS Pro (veya hediye edilmiş bir kopya) gerektiren Pro'ya özel öğeler bunun istisnasıdır. Çağıranın kuşandığı kozmetikleri döndürür.

Kozmetik hediyeleri¶

GET /shop/cosmetic-gifts, çağırana gönderilmiş ve henüz alınmamış kozmetik hediyelerini {"gifts": [{id, sender_id, item_type, item_id, message}]} olarak listeler. POST /shop/cosmetic-gifts/claim bunları alır ve 204 döndürür.