Kullanıcılar¶

Kullanıcı bir TEBHOS hesabıdır. Diğer hesaplar kısmi kullanıcı nesnesini, hesabın sahibi ise kullanıcı nesnesini görür. Kendi hesabınızdaki değişiklikler Geçerli kullanıcı sayfasında ele alınır.

Bu sayfadaki tüm yollar https://tebhos.com/api/v1 adresine görelidir.

Kullanıcı yollarında kimlik doğrulama¶

Token'ların nasıl alındığı için bkz. Kimlik doğrulama.

Kısmi kullanıcı nesnesi¶

Genel hesap gösterimi. Kullanıcıyı getir ucunun döndürdüğü ve diğer kaynakların author, user ve benzeri alanlar olarak gömdüğü nesnedir.

Yapı¶

Örnek¶

{
  "id": "1501314428688998182",
  "username": "aria",
  "discriminator": "0",
  "global_name": "Aria",
  "avatar": "a_2f1c9d7be4a350c8e0f1",
  "avatar_color": 5793266,
  "flags": 0
}

Silinmiş ve sistem hesapları¶

Silinmesi tamamlanmış bir hesap, kullanıcı nesnesinde ve API'nin oluşturduğu gömülü yazar nesnelerinde DeletedUser kullanıcı adı, 0000 ayırıcı, Deleted User genel adı, null avatar ve avatar_color ile 0 değerinde flags olarak serileştirilir. Yalnızca silinmek üzere zamanlanmış bir hesap, bekleme süresi boyunca normal gösterimini korur.

Yerleşik sistem hesabının kimliği 0, kullanıcı adı TEBHOS, ayırıcısı 0000'dır; bot ve system değerleri true olarak ayarlıdır ve STAFF bayrağına sahiptir. TEBHOS sistem mesajlarını bu hesap gönderir.

Görsel hash'leri¶

avatar ve banner bir URL değil, bir içerik hash'i tutar. a_ ile başlayan bir hash hareketli bir görsele aittir. URL'yi hash'ten oluşturun:

https://tebhos.com/api/v1/avatars/{user_id}/{avatar_hash}.webp
https://tebhos.com/api/v1/banners/{user_id}/{banner_hash}.webp

Boyutlar ve biçimler için bkz. Medya vekili yolları. Avatarı olmayan bir hesapta avatar: null bulunur; istemciler kullanıcı kimliğinden türetilen varsayılan bir avatar çizer.

Hareketli avatarlar ve tüm profil afişleri TEBHOS Pro özellikleridir. Hesabın etkin Premium üyeliği yokken (botlar her zaman hak sahibidir), kullanıcı nesnesinde avatar hash'inden a_ öneki kaldırılır ve banner null olur.

Genel kullanıcı bayrakları¶

flags, hesabın saklanan bayraklarının herkese açık alt kümesini tutar. Hesapta gizli personel bayrağı da varsa STAFF kaldırılır.

Yanıt bahsetme tercihleri¶

Biri bu hesabın mesajlarından birine yanıt verdiğinde uygulanan hesap geneli varsayılan. mention_flags aşağıdaki değerlerden biridir ve saklanan değer 0 iken serileştirilmiş kullanıcıdan çıkarılır. Geçerli kullanıcıyı değiştir ile ayarlanır.

Kullanıcı nesnesi¶

Geçerli hesabın özel gösterimi; Geçerli kullanıcıyı getir ve hesabı değiştiren işlemler tarafından döndürülür. Kısmi kullanıcı nesnesini genişletir.

Yapı¶

Premium durumu şöyle hesaplanır: hesap bir botsa, bir personel geçersiz kılması ayarlıysa ya da premium_until değeri geçmemiş ücretli bir Premium türüne sahipse Premium'dur. premium_until sonrasında haklar premium_grace_ends_at değerine kadar, bu değer null ise 3 gün boyunca etkin kalır. premium_perks_disabled hakları her durumda kapatır.

Örnek¶

{
  "id": "1501314428688998182",
  "username": "aria",
  "discriminator": "0000",
  "global_name": "Aria",
  "avatar": "2f1c9d7be4a350c8e0f1",
  "avatar_color": 5793266,
  "flags": 0,
  "is_staff": false,
  "acls": [],
  "traits": [],
  "email": "[email protected]",
  "email_bounced": false,
  "phone": null,
  "has_verified_phone": false,
  "bio": "Hello!",
  "pronouns": null,
  "accent_color": null,
  "timezone": "Europe/Istanbul",
  "timezone_privacy_flags": 1,
  "banner": null,
  "banner_color": null,
  "mfa_enabled": true,
  "authenticator_types": [0],
  "verified": true,
  "premium_type": 0,
  "premium_since": null,
  "premium_until": null,
  "premium_will_cancel": false,
  "premium_billing_cycle": null,
  "premium_lifetime_sequence": null,
  "premium_grace_ends_at": null,
  "premium_discriminator": false,
  "premium_badge_hidden": false,
  "premium_badge_masked": false,
  "premium_badge_timestamp_hidden": false,
  "premium_badge_sequence_hidden": false,
  "premium_purchase_disabled": false,
  "premium_enabled_override": false,
  "premium_perks_disabled": false,
  "password_last_changed_at": "2026-08-01T10:15:00.000Z",
  "last_voice_activity_sharing_change_at": null,
  "required_actions": [],
  "nsfw_allowed": false,
  "has_dismissed_premium_onboarding": false,
  "has_ever_purchased": false,
  "has_unread_gift_inventory": false,
  "unread_gift_inventory_count": 0,
  "terms_agreed_at": "2026-07-20T08:00:00.000Z",
  "privacy_agreed_at": "2026-07-20T08:00:00.000Z",
  "pending_bulk_message_deletion": null
}

Bekleyen toplu mesaj silme nesnesi¶

Hesabın gönderdiği tüm mesajların silinmesi zamanlanmışken bulunur (bkz. İçerik).

Sayılar, silme zamanlandığında hesaplanır.

Doğrulayıcı türleri¶

authenticator_types yalnızca bu iki değeri içerir. TEBHOS'ta bir geçiş anahtarı (passkey) kaydetmek WEBAUTHN eklemez; bu yüzden dizi bugün yalnızca TOTP bildirir ve mfa_enabled yalnızca TOTP'yi yansıtır. Geçiş anahtarları sudo doğrulaması için yine de ikinci faktör sayılır. Bkz. MFA.

Premium türleri¶

TEBHOS'un Polar üzerinden yürüttüğü satın alma işlemleri için bkz. Premium.

Profil alanı gizlilik bayrakları¶

Tek bir profil alanını (saat dilimi ve her bağlantı) kimin görebileceğini denetler. 0 değeri, alanı sahibin kendi profil kartı dahil herkesten gizler.

Kullanıcı ayarları nesnesi¶

Hesap genelindeki ayarlar kaydının tamamı. Geçerli kullanıcı ayarlarını getir ve Geçerli kullanıcı ayarlarını değiştir bunu döndürür; USER_SETTINGS_UPDATE Gateway olayı da bunu taşır. Aşağıdaki her alan her zaman bulunur. Hiç yazılmamış bir alan başlangıç değeriyle döndürülür.

Yapı¶

Özel durum nesnesi¶

Hesabın adının altında gösterilen metin ve emoji. Profille birlikte saklanır; bu yüzden Geçerli kullanıcı ayarlarını değiştir ve Geçerli kullanıcıyı değiştir ucunun özel durum alanları aynı değeri yazar.

Süresi dolmuş bir durum null olarak döndürülür.

{
  "text": "shipping",
  "emoji_id": null,
  "emoji_name": "🚀",
  "emoji_animated": false,
  "expires_at": "2026-09-24T18:00:00+00:00"
}

Sunucu klasörü nesnesi¶

Sunucu kenar çubuğu düzeninin bir girdisi.

Bir sunucudan ayrılmak veya çıkarılmak, sunucunun kimliğini tüm klasörlerden kaldırır ve boşalan, kategorisiz olmayan her klasörü siler. Bir sunucuya katılmak düzeni değiştirmez.

{
  "id": -1,
  "name": null,
  "color": 0,
  "flags": 0,
  "icon": "folder",
  "guild_ids": ["1501314428688998182", "1501314428688998183"]
}

Sunucu klasörü bayrakları¶

Sunucu klasörü simgeleri¶

Çıkartma animasyonu ayarları¶

Sürprizbozan gösterim ayarları¶

Saat biçimi ayarları¶

Hassas medya filtreleri¶

Üç değer de sensitive_content_guild_filter dahil her filtre alanında kabul edilir.

Profil gizlilik düzeyleri¶

Tam profili kimin gördüğünü denetler. Arkadaşlar ve hesabın kendisi onu her zaman görür; bot profilleri hiçbir zaman kısıtlanmaz.

Kısıtlanan bir görüntüleyici profili yine alır, ancak bio, pronouns, Premium rozeti, timezone_offset ve connected_accounts kaldırılmış ve profile_limited: true eklenmiş olarak. Bkz. Kullanıcı profilini getir ve Kullanıcı profil kartını getir. Profili getir, kısıtlanan bir görüntüleyici için bio ve pronouns değerlerini kaldırır.

Arkadaşlık kaynağı bayrakları¶

Hesaba kimin arkadaşlık isteği gönderebileceği.

Gelen arama bayrakları¶

Hesapla kimin DM araması başlatabileceği. SILENT_EVERYONE, izin verilen aramaların çalmadan gelmesini sağlar.

Saklanırken FRIENDS_ONLY içeren bir değer tek başına FRIENDS_ONLY olur; aksi hâlde NOBODY içeren bir değer tek başına NOBODY olur. Her iki durumda da SILENT_EVERYONE korunur.

Grup DM'ye ekleme izni bayrakları¶

Hesabı bir grup DM'ye kimin ekleyebileceği.

Saklanırken FRIENDS_ONLY, NOBODY üzerinde; NOBODY ise EVERYONE üzerinde üstünlük kurar. Kazanan bayrak tek başına saklanır.

Kullanıcı profili nesnesi¶

Kullanıcı profilini getir tarafından döndürülen kayıt.

Profil nesnesi¶

Profili getir tarafından döndürülen profil kaydı. Temel hesap alanlarını TEBHOS profil özelleştirmesiyle birleştirir.

Profil kartı nesnesi¶

Kullanıcı profil kartını getir tarafından döndürülen daha zengin kayıt. İstek bir sunucu belirttiğinde üst düzey image_url, bio, pronouns, accent_color ve afiş alanları üyenin etkin değerlerini tutar (sunucu başına profili genel profili geçersiz kılar).

Ortak sunucu nesnesi¶

Ortak arkadaş nesnesi¶

Rol özeti nesnesi¶

Üye profili nesnesi¶

Profil bağlantısı nesnesi¶

Kullanıcıyı getir¶

GET /users/{user_id}

Herhangi bir hesabın kısmi kullanıcı nesnesini döndürür. Hedefle bir ilişki gerekmez. Yalnızca kullanıcı oturumları içindir.

Yol parametreleri¶

Yanıt¶

Yanıt TEBHOS kullanıcı hizmetinden gelir. Saklanan avatar hash'ini değiştirmeden döndürür (a_ öneki dahil) ve silinmiş hesap yer tutucusunu yerine koymaz.

Hız sınırı¶

user:read kovasında, istemci ve hedef başına 10 saniyede 100 istek.

curl https://tebhos.com/api/v1/users/1501314428688998182 \
  -H "Authorization: Bearer $TEBHOS_TOKEN"

Kullanıcı profilini getir¶

GET /users/{user_id}/profile

Kullanıcı profili nesnesini döndürür. Kullanıcı oturumlarını ve bot token'larını kabul eder. user_id değeri @me olabilir.

Sorgu parametreleri¶

Gizlilik¶

• Erişim. Hedef bir bot veya kendiniz değilse, hedefle arkadaş olmanız, her iki yönde bekleyen bir arkadaşlık isteğinizin olması, ortak bir sunucuyu ya da ortak bir grup doğrudan mesajını paylaşmanız gerekir. Aksi hâlde istek 403 MISSING_ACCESS ile başarısız olur.
• Kısıtlama. Tam profili görüp görmeyeceğinize hedefin profil gizlilik düzeyi karar verir; kısıtlı bir profil profile_limited: true taşır.
• Alanlar. timezone_offset ve her bağlantı kendi profil alanı gizlilik bayraklarına göre filtrelenir.

Yanıt¶

Hız sınırı¶

user:profile kovasında, çağıran ve hedef başına 10 saniyede 100 istek.

curl "https://tebhos.com/api/v1/users/1501314428688998182/profile?with_mutual_guilds=true" \
  -H "Authorization: Bot $TEBHOS_BOT_TOKEN"

Profili getir¶

GET /profile/{user_id}

Herhangi bir hesabın TEBHOS profil nesnesini döndürür. Kullanıcı oturumlarını ve bot token'larını kabul eder. Hedefle bir ilişki gerekmez. Hedefin profil gizlilik düzeyi sizi kısıtlıyorsa bio ve pronouns null olur; diğer alanlar her zaman döndürülür. Gizlilik kurallarının tamamı için Kullanıcı profilini getir ucunu kullanın.

Yanıt¶

Hız sınırı¶

user:profile kovasında, çağıran ve hedef başına 10 saniyede 100 istek.

Kullanıcı profil kartını getir¶

GET /profile/{user_id}/card

Profil kartı nesnesini döndürür; bu nesne ortak sunucuları ve arkadaşları, ilişkinizi, notunuzu ve takma adınızı, görünür bağlantıları, saat dilimi farkını ve isteğe bağlı sunucu başına üye verisini ekler. Kullanıcı oturumlarını ve bot token'larını kabul eder.

Sorgu parametreleri¶

Davranış¶

• Kartı okumak için hedefle bir ilişki gerekmez.
• Kendi kartınızı okumuyorsanız, hedef bir bot değilse veya arkadaş değilseniz, kartın kısıtlanıp kısıtlanmayacağına hedefin profil gizlilik düzeyi karar verir. Kısıtlı bir kart bio, pronouns ve premium_since değerlerini (member_profile içinde de) null yapar, timezone_offset değerini null'a ayarlar, connected_accounts dizisini boşaltır ve profile_limited: true ekler.
• timezone_offset ve her bağlantı ayrıca kendi profil alanı gizlilik bayraklarına göre filtrelenir.

Yanıt¶

curl "https://tebhos.com/api/v1/profile/1501314428688998182/card?server_id=1501314428688998100" \
  -H "Authorization: Bearer $TEBHOS_TOKEN"

Kullanıcı etiketini denetle¶

GET /users/check-tag

Bir kullanıcı adı ve ayırıcı çiftinin zaten alınıp alınmadığını bildirir. Yalnızca kullanıcı oturumları içindir.

Sorgu parametreleri¶

Kendi geçerli etiketiniz false bildirir. Yol biçim doğrulaması yapmaz; kullanıcı adını gerçekten değiştirdiğinizde uygulanan kurallar için bkz. Geçerli kullanıcıyı değiştir.

Yanıt gövdesi¶

Hız sınırı¶

user:check_tag kovasında, kullanıcı başına 10 saniyede 60 istek.

{ "taken": false }