Hediyeler¶
Bir hediye kodu, onu kullanan hesaba TEBHOS Pro süresi kazandırır. Kullanılana kadar hiçbir hesaba ait değildir.
Hediye satın alma
Hediye ödemesi oluştur ile hediye olarak satın alınan TEBHOS Pro, doğrudan seçilen arkadaşa uygulanır. Satın alma yine de bir hediye kodu olarak kaydedilir ve alıcı tarafından kullanılmış olarak işaretlenir. Alıcının ömür boyu Premium üyeliği varsa kod kullanılmamış bırakılır; böylece satın alan kişi kodu başkasına verebilir. Kullanıcının satın aldığı kodlar Hediyelerimi listele ile listelenir.
Kod, taşıyana ait bir kimlik bilgisidir
Hediye kodu bir alıcı belirtmez; kodu ilk kullanan süreyi alır. Hediyeyi getir hiçbir kimlik bilgisi gerektirmez. Kullanılmamış bir kodu gizli tutun.
Hediye nesnesi¶
Yapı¶
| Alan | Tür | Açıklama |
|---|---|---|
| code | string | Kod; 32 küçük harfli onaltılık karakter |
| duration_type | ?string | Hediye süre birimi |
| duration_quantity | ?integer | Hediyenin kazandırdığı duration_type birimi sayısı |
| redeemed | boolean | Kodun daha önce kullanılıp kullanılmadığı |
| created_by | ?object | Hediyeyi satın alan veya oluşturan hesabın {username, name} bilgisi; çözümlenemiyorsa null |
Örnek¶
{
"code": "3f9c1e2d4b5a60718293a4b5c6d7e8f9",
"duration_type": "months",
"duration_quantity": 1,
"redeemed": false,
"created_by": { "username": "example", "name": "Example" }
}
Hediye süre birimleri¶
| Değer | Birim başına eklenen gün |
|---|---|
| days | 1 |
| weeks | 7 |
| months | 30 |
| years | 365 |
Satın almalardan oluşturulan kodlar her zaman months kullanır. Tanınmayan bir birim months olarak değerlendirilir.
Hediyeyi getir¶
GET /gifts/{code}
Bir kodun hediye nesnesini döndürür. Kimlik doğrulama gerekmez.
Yanıt¶
| Durum | Gövde | Koşul |
|---|---|---|
| 200 | hediye nesnesi | Kod mevcut |
| 404 | hata yanıtı | Bu koda sahip hediye yok (NOT_FOUND, mesaj UNKNOWN_GIFT_CODE) |
Hız sınırı¶
gift:get kovasında, istemci başına 10 saniyede 60 istek.
Örnek¶
Hediyeyi kullan¶
POST /gifts/{code}/redeem
Bir hediye kodunu kimliği doğrulanmış hesap için kullanır ve boş gövdeyle 204 döndürür. Yalnızca kullanıcılar içindir: bot token'ı 403 ACCESS_DENIED ile reddedilir.
Hediyenin süresi hesabın mevcut Premium bitiş tarihinin üzerine eklenir; böylece etkin bir abonelik değiştirilmez, uzatılır.
Yanıt¶
Hata code değeri genel HTTP kodudur; asıl neden message içindedir.
| Durum | Gövde | Koşul |
|---|---|---|
| 204 | boş | Kod kullanıldı ve Premium uzatıldı |
| 400 | hata yanıtı | message GIFT_CODE_ALREADY_REDEEMED: kod daha önce kullanılmış |
| 400 | hata yanıtı | message GIFT_CODE_REDEMPTION_IN_PROGRESS: aynı kodun başka bir kullanımı sürüyor |
| 400 | hata yanıtı | message CANNOT_REDEEM_WITH_LIFETIME: hesabın zaten ömür boyu Premium üyeliği var; kod bunun yerine bir arkadaşa verilebilir |
| 404 | hata yanıtı | message UNKNOWN_GIFT_CODE: bu koda sahip hediye yok |
Yan etkiler¶
Kullanım, kod başına bir kilitle korunur; bu nedenle aynı anda gelen iki isteğin ikisi birden başarılı olamaz. Premium uzatma başarısız olursa kod yeniden serbest bırakılır ve işlem tekrar denenebilir.
Hız sınırı¶
gift:redeem kovasında, kullanıcı başına dakikada 10 istek.