Hediye envanteri¶
Hediye envanteri, geçerli hesabın satın aldığı premium hediye kodlarını ve her kodun kullanılıp kullanılmadığını listeler. Herkese açık hediye sorgulama ve kullanma işlemleri Hediyeler kaynağındadır. Satın almalar Faturalandırma kaynağı üzerinden yapılır ve TEBHOS ödemeleri Polar ile işler.
Bir kod bu envantere yalnızca hediye ödemesi alıcı belirtilmeden yapıldığında eklenir. Alıcı ödeme sırasında bir arkadaşını seçtiğinde TEBHOS premium'u doğrudan o arkadaşa verir ve kod oluşturmaz; bu yüzden burada hiçbir şey görünmez.
Aldığınız bir hediye envanterde hiçbir zaman görünmez
Bir kodu burada yalnızca onu satın alan hesap görür.
Okunmamış işareti TEBHOS'ta yükseltilmez
User nesnesinde has_unread_gift_inventory ve unread_gift_inventory_count bulunur ve Geçerli kullanıcıyı değiştir has_unread_gift_inventory: false kabul eder. TEBHOS şu anda yeni bir kod verildiğinde bu işareti yükseltmez; bu yüzden değer false / 0 olarak kalır. İşareti beklemek yerine Geçerli kullanıcının hediyelerini listele yolunu çağırın.
Hediye envanteri nesnesi¶
Geçerli hesabın satın aldığı, kullanım durumuyla birlikte tek bir hediye kodu. Ödeme sağlayıcısı bildirimini birden fazla kez gönderse bile ödenmiş bir sipariş en fazla bir kod üretir.
Yapı¶
| Alan | Tür | Açıklama |
|---|---|---|
| code | string | Alıcının Hediyeyi kullan içine girdiği kod. Satın alınan kodlar 32 küçük harfli onaltılık karakterdir |
| duration_type | string | duration_quantity biriminin türü: days, weeks, months veya years. Satın alınan kodlar her zaman months kullanır |
| duration_quantity | integer | Kodun kaç duration_type birimi sağladığı. Satın alınan bir kod için satın alınan ay sayısıdır (en az 1) |
| created_at | ISO8601 zaman damgası | Kodun oluşturulduğu zaman |
| created_by | ?object | Her zaman geçerli hesap olan satın alan, {"username", "name"} olarak. Hesap kaydı okunamazsa null |
| redeemed_at | ?ISO8601 zaman damgası | Kodun kullanıldığı zaman; kullanılmadıysa null |
| redeemed_by | ?object | Kodu kullanan hesap, {"username", "name"} olarak, ya da null |
created_by ve redeemed_by yalnızca username ve name (görünen ad) içerir. Kullanıcı kimliği içermezler. Kullanan hesabı artık var olmayan, kullanılmış bir kod için redeemed_by null olabilir; bu yüzden bir kodun kullanılıp kullanılmadığını anlamak için redeemed_at değerini kullanın.
Bir kod kullanıldığında, kullananın premium süresi kodun süresi kadar uzatılır. TEBHOS bir ayı 30 gün, bir yılı 365 gün olarak sayar.
Kod bir parola gibi çalışır
TEBHOS bir kod verildiğinde alıcı kaydetmez. Kullanma işlemi kodu, onu sunan ilk uygun hesaba verir. Envanter kodun tamamını döndürür ve kullanılmış bir kod sıfırlanamaz. Kullanılmamış her kodu gizli tutun.
Örnek¶
{
"code": "3f9c2a7e5b1d4c8e9a0b6d2f7c4e1a85",
"duration_type": "months",
"duration_quantity": 1,
"created_at": "2026-09-11T12:04:33.000+00:00",
"created_by": {"username": "aria", "name": "Aria"},
"redeemed_at": null,
"redeemed_by": null
}
Geçerli kullanıcının hediyelerini listele¶
GET /users/@me/gifts
Geçerli hesabın satın aldığı hediye kodlarını en yeniden başlayarak listeler. Hediye envanteri nesnelerinden oluşan bir dizi döndürür.
Liste sayfalanmaz. Sorgu parametresi kabul etmez ve imleç döndürmez.
Kullanılmamış bir kod var olduğu sürece listede kalır. Kullanılmış bir kod yalnızca kullanıldıktan sonraki 7 gün boyunca listelenir; bu yüzden kodlarının hepsi bundan önce kullanılmış bir hesap boş bir dizi alır. Artık listelenmeyen kullanılmış bir kod yine de vardır, Hediyeler kaynağı üzerinden sorgulanabilir ve yeniden kullanılamaz.
Yanıt¶
| Durum | Gövde | Koşul |
|---|---|---|
| 200 | hediye envanteri nesnelerinden oluşan dizi | Envanter döndürüldü |
| 403 | hata yanıtı | Bot token'ı kullanıldı (ACCESS_DENIED) |
Hız sınırı¶
gifts:list kovasında, kullanıcı başına 10 saniyede 40 istek. Bkz. Hız sınırları.
Hediye envanterini al (ayarlar görünümü)¶
GET /auth/me/gifts
Aynı kodları aynı kurallarla (çağıranın satın aldığı kodlar, kullanılmış kodlar 7 gün sonra gizlenir, en yeniden başlayarak), TEBHOS ayarlarındaki hediyeler sekmesinin kullandığı biçimde döndürür. Dizi bir gifts nesnesine sarılır.
| Alan | Tür | Açıklama |
|---|---|---|
| code | string | Hediye kodu |
| duration_type | string | Hediye envanteri nesnesindeki gibi. Saklanmamışsa varsayılan months |
| duration_quantity | integer | Hediye envanteri nesnesindeki gibi. Saklanmamışsa varsayılan 1 |
| duration_months | integer | Ay cinsinden süre: months için duration_quantity, years için duration_quantity × 12, days veya weeks için 1 |
| created_at | ISO8601 zaman damgası | Kodun oluşturulduğu zaman |
| redeemed_at | ?ISO8601 zaman damgası | Kodun kullanıldığı zaman ya da null |
| redeemed_by_username | ?string | Kullananın kullanıcı adı ya da null |
{
"gifts": [
{
"code": "3f9c2a7e5b1d4c8e9a0b6d2f7c4e1a85",
"duration_months": 12,
"duration_type": "months",
"duration_quantity": 12,
"created_at": "2026-09-11T12:04:33.000+00:00",
"redeemed_at": "2026-09-12T08:00:10.000+00:00",
"redeemed_by_username": "deniz"
}
]
}
Bu yolun yol düzeyinde hız sınırı yoktur. Yeni entegrasyonlar Geçerli kullanıcının hediyelerini listele yolunu kullanmalıdır.