Kullanıcı içerik koleksiyonları¶

Son bahsetmeler, kaydedilen mesajlar ve zamanlanmış mesajlar, yalnız sahibi olan hesabın okuyabildiği özel listelerdir. Bu sayfadaki diğer yollar çağıranın yazdığı mesajları siler: biri bir filtreyle hemen çalışır, diğeri her şeyi siler ve bir gün bekler. Veri dışa aktarımları Veri toplama sayfasında ele alınır.

Buradaki tüm yollar yalnız kullanıcı hesapları içindir. Bot token'ı ile yapılan istek, token geçerliyse 403 ACCESS_DENIED, değilse 401 ile reddedilir (bkz. Kimlik doğrulama). Hatalar error, code ve message alanlarını içeren standart hata yanıtını kullanır.

Kaydedilen mesaj nesnesi¶

Kaydedilen bir öğe, bir mesajı kaydedildiği kanalla eşleştiren özel bir yer imidir. Bir mesajı kaydetmek, yazarı dahil hiç kimseye bildirim göndermez.

Öğe mesajın bir kopyasını saklamaz. TEBHOS her liste isteğinde mesajı yeniden okur; bu yüzden bir öğe bir okumada içerik taşıyıp sonrakinde taşımayabilir.

Yapı¶

Öğe tam bir mesaj nesnesi değil, mesajın bir özetidir. Ekleri, gömmeleri ve tepkileri almak için mesaj kendi kanalından getirilmelidir.

Kaydedilen mesaj durumları¶

Son bahsetme nesnesi¶

Bir mesaj hesaptan bahsettiğinde otomatik olarak bir son bahsetme öğesi oluşturulur. Öğe oluşturmak için bir yol yoktur. Öğeler kaydedildikten 7 gün sonra depodan silinir.

Yapı¶

Son bahsetmeleri listele¶

GET /users/@me/mentions

Çağıran için en yeniden başlayarak (azalan mesaj kimliğine göre) en fazla 100 son bahsetme öğesinden oluşan bir dizi döndürür.

Bu yol sorgu parametresi almaz: limit, before veya filtre yoktur ve yanıtta imleç bulunmaz. Öğeler saklanan kayıtlardır. TEBHOS mesajları yüklemez veya çağıranın güncel izinlerine göre denetlemez; bu yüzden bir öğe o zamandan beri silinmiş bir mesaja işaret edebilir. Mesajı göstermek için kendi kanalından getirilmelidir.

Yanıt¶

[
  {
    "message_id": "1501314428688998182",
    "channel_id": "1501300000000000001",
    "guild_id": "1501299999999999999",
    "mention_everyone": false,
    "mention_role": false
  }
]

Hız sınırı¶

user:mentions:read kovasında kullanıcı başına 10 saniyede 40 istek. Bkz. Hız sınırları.

Son bahsetmeleri okundu işaretle¶

POST /users/@me/mentions/read

Çağıranın son bahsetme geçmişinden her öğeyi kaldırır. İstek gövdesi almaz ve boş gövdeyle 204 döndürür.

Öğeleri kaldırmak mesajları okundu olarak işaretlemez. Her kanaldaki okunmamış bahsetme sayısı aynı kalır. Onaylama (acknowledgement) Okuma durumları sayfasında açıklanır.

Yan etkiler¶

TEBHOS en yeni 1000 öğeye kadar okur, tüm geçmişi siler ve ardından okuduğu her öğe için çağıranın tüm oturumlarına bir RECENT_MENTION_DELETE Gateway olayı ({"message_id": "..."}) gönderir.

Hız sınırı¶

user:mentions:delete kovasında kullanıcı başına 10 saniyede 60 istek. Bu kova Son bahsetmeyi sil ile paylaşılır.

Son bahsetmeyi sil¶

DELETE /users/@me/mentions/{message_id}

Çağıranın son bahsetme geçmişinden bir öğeyi kaldırır ve boş gövdeyle 204 döndürür.

Yol parametreleri¶

Yanıt¶

Yan etkiler¶

TEBHOS öğeyi çağıranın en yeni 200 öğesi arasında arar. Eşleşme bulursa öğeyi siler ve çağıranın tüm oturumlarına RECENT_MENTION_DELETE ({"message_id": "..."}) gönderir. Eşleşme yoksa (en yeni 200'den eski bir öğe dahil) hiçbir şey yazılmaz ve olay gönderilmez. Mesaj kanalında kalır.

Hız sınırı¶

user:mentions:delete kovasında kullanıcı başına 10 saniyede 60 istek. Bu kova Son bahsetmeleri okundu işaretle ile paylaşılır.

Kaydedilen mesajları listele¶

GET /users/@me/saved-messages

Çağıranın kaydedilen mesajlarını en yeniden başlayarak (azalan mesaj kimliğine göre) döndürür. Yanıt, kaydedilen mesaj nesnelerinden oluşan bir items dizisi içeren bir nesnedir. İmleç yoktur; sayfalama için before ve limit kullanılır.

TEBHOS VIEW_CHANNEL iznini her kanal için bir kez denetler. Çağıranın artık görüntüleyemediği bir kanala ait öğe missing_permissions durumuyla döndürülür. Mesajı artık var olmayan bir öğe yanıta dahil edilmez, ancak silinmez. Bu nedenle items, limit değerinden daha az öğe içerebilir.

Sorgu parametreleri¶

Yanıt¶

{
  "items": [
    {
      "id": "1501314428688998182",
      "message_id": "1501314428688998182",
      "saved_at": "2026-09-20T18:04:33.120+00:00",
      "channel_id": "1501300000000000001",
      "status": "available",
      "content": "Meeting notes are pinned.",
      "is_deleted": false,
      "created_at": null,
      "author": {"id": "1501290000000000042", "username": "aria", "discriminator": "0", "global_name": "Aria", "avatar": null, "avatar_color": null, "flags": 0}
    }
  ]
}

Hız sınırı¶

user:saved_messages:read kovasında kullanıcı başına 10 saniyede 40 istek.

Mesajı kaydet¶

POST /users/@me/saved-messages

Bir mesajı çağıranın kaydedilenler koleksiyonuna ekler ve boş gövdeyle 204 döndürür. Çağıranın bir sunucu kanalında VIEW_CHANNEL iznine sahip olması ya da bir DM veya grup DM'nin alıcısı olması gerekir.

JSON gövdesi¶

Koleksiyon sınırı¶

Bir hesap en fazla 100 mesaj kaydedebilir. Bu, örnek (instance) ayarı değil, sabit bir sınırdır. Koleksiyon doluyken yeni bir mesaj kaydetmek 400 BAD_REQUEST döndürür. Zaten koleksiyonda bulunan bir mesajı kaydetmek, koleksiyon dolu olsa bile her zaman kabul edilir.

Yanıt¶

Yan etkiler¶

Zaten saklanan bir mesajı kaydetmek öğeyi yeniden yazar. Kabul edilen her kaydetmede çağıranın tüm oturumlarına SAVED_MESSAGE_CREATE gönderilir. Yükü, çağıranın görebildiği biçimiyle tam mesaj nesnesidir; buna user_id ve message_id eklenir. Mesaj olay için yüklenemezse kaydetme yine başarılı olur, ancak olay gönderilmez.

Hız sınırı¶

user:saved_messages:write kovasında kullanıcı başına 10 saniyede 30 istek. Bu kova Mesaj kaydını kaldır ile paylaşılır.

Mesaj kaydını kaldır¶

DELETE /users/@me/saved-messages/{message_id}

Bir mesajı çağıranın kaydedilenler koleksiyonundan kaldırır ve boş gövdeyle 204 döndürür. Çağıranın kanala o anda erişimi olması gerekmez.

Yol parametreleri¶

Yanıt¶

Yan etkiler¶

TEBHOS silme işlemini her zaman çalıştırır. Hesabın hiç kaydetmediği bir mesaj için yapılan istek dahil, kabul edilen her istekte çağıranın tüm oturumlarına SAVED_MESSAGE_DELETE ({"user_id": "...", "message_id": "..."}) gönderilir. Mesaj kanalında kalır.

Hız sınırı¶

user:saved_messages:write kovasında kullanıcı başına 10 saniyede 30 istek. Bu kova Mesajı kaydet ile paylaşılır.

Zamanlanmış mesaj nesnesi¶

Zamanlanmış mesaj, TEBHOS'un çağıran adına daha sonraki bir zamanda bir kanala gönderdiği metindir. Bir arka plan işçisi zamanı gelen mesajları 30 saniyede bir denetler; bu yüzden bir mesaj scheduled_at zamanından en fazla yaklaşık 30 saniye sonra gönderilir.

Yapı¶

Zamanlanmış bir mesaj gönderildiğinde listeden kaldırılır ve kanala normal bir MESSAGE_CREATE gönderilir. Gönderim başarısız olursa öğe geçersiz olarak işaretlenir ve yeniden denenmez. Geçersiz öğeler aşağıdaki tüm yollarda gizlenir.

Mesaj zamanla¶

POST /scheduled-messages

Bir mesajı zamanlar ve zamanlanmış mesaj nesnesiyle 201 döndürür. Çağıranın hedef kanalda SEND_MESSAGES iznine sahip olması gerekir. Aynı işlem, kanalı yoldan alan POST /channels/{channel_id}/messages/schedule olarak da kullanılabilir (bkz. Mesajlar).

JSON gövdesi¶

Sınırlar¶

Bir hesabın en fazla 50 bekleyen zamanlanmış mesajı olabilir. 51'incisi 400 BAD_REQUEST döndürür.

Yanıt¶

Zamanlanmış mesajları listele¶

GET /users/@me/scheduled-messages

GET /scheduled-messages olarak da kullanılabilir. En fazla 100 bekleyen öğeyle {"items": [scheduled message object]} döndürür. Zaten gönderilmiş veya geçersiz olarak işaretlenmiş öğeler dahil edilmez. Öğelerin sırası tanımlı değildir.

Zamanlanmış mesajı al¶

GET /users/@me/scheduled-messages/{id}

GET /scheduled-messages/{id} olarak da kullanılabilir. Bekleyen bir zamanlanmış mesajı döndürür. Başka bir hesaba ait, zaten gönderilmiş veya geçersiz olarak işaretlenmiş bir mesaj 404 NOT_FOUND döndürür.

Zamanlanmış mesajı düzenle¶

PATCH /scheduled-messages/{id}

Bekleyen bir zamanlanmış mesajın metnini veya zamanını değiştirir ve boş gövdeyle 204 döndürür.

Zamanlanmış mesaj yoksa veya başka bir hesaba aitse 404 NOT_FOUND döndürür.

Zamanlanmış mesajı iptal et¶

DELETE /users/@me/scheduled-messages/{id}

DELETE /scheduled-messages/{id} olarak da kullanılabilir. Bekleyen bir zamanlanmış mesajı iptal eder ve boş gövdeyle 204 döndürür. Mesaj yoksa, başka bir hesaba aitse veya zaten gönderilmişse 404 NOT_FOUND döndürür.

Zamanlanmış mesaj yollarının yol düzeyinde hız sınırı yoktur.

Geçerli kullanıcının mesajlarını sil¶

POST /users/@me/messages/bulk-delete-mine

Çağıranın, gövdede seçilen kanal türlerinde yazdığı mesajları siler. Sudo kipi gerektirir ve boş gövdeyle 202 döndürür.

Sudo kipi¶

Bu yol, geçerli oturumun sahip olduğu bir sudo yetkisini denetler. Bu yetki 5 dakika geçerli olan POST /auth/sudo ile alınır (bkz. MFA). İstek gövdesindeki sudo alanları yok sayılır. Geçerli bir yetki yoksa yol code değeri SUDO_MODE_REQUIRED olan 403 döndürür.

JSON gövdesi¶

Her alan isteğe bağlıdır.

Mesaj zamanı, mesaj snowflake değerindeki zaman damgasından gelir; bu yüzden bir mesajı düzenlemek onun hangi zaman aralığına düştüğünü değiştirmez.

Davranış¶

• Silme istek açıkken çalışır. 202 döndürüldüğünde mesajlar silinmiş olur.
• Yalnız çağıranın en son 10.000 mesajı dikkate alınır. Daha eski mesajları silmek için istek yeniden gönderilir.
• Etkilenen her kanal için TEBHOS o kanala bir MESSAGE_DELETE_BULK olayı ({"channel_id": "...", "ids": [...]}) gönderir.
• Silme bittiğinde özet doğrudan mesaj gönderilmez.

Yanıt¶

Hız sınırı¶

user:messages:bulk_delete_mine_filtered kovasında kullanıcı başına 30 dakikada 5 istek. Sınır sudo'dan önce denetlenir.

Geçerli kullanıcının bir sunucudaki mesajlarını sil¶

POST /users/@me/guilds/{guild_id}/messages/bulk-delete-mine

Çağıranın bir sunucunun herhangi bir kanalında yazdığı her mesajı siler. Çağıran sunucunun üyesi olmalıdır; değilse yol 404 NOT_FOUND döndürür. Yol, Geçerli kullanıcının mesajlarını sil ile aynı oturum sudo yetkisini gerektirir. Gövde almaz ve silme bittiğinde 202 döndürür. Çağıranın en son 10.000 mesajını dikkate alır ve kanal başına bir MESSAGE_DELETE_BULK olayı gönderir.

Hız sınırı: guild:leave kovasında kullanıcı ve sunucu başına 10 saniyede 10 istek.

Toplu mesaj silme iste¶

POST /profile/purge-messages

Çağıranın gönderdiği her mesajın, şu andan 24 saat sonra başlayacak şekilde silinmesini zamanlar. Zamanlamayla 200 döndürür. Geçerli kullanıcının mesajlarını sil yolundan farklı olarak bu yol filtre almaz ve bir gün bekler. O zamana kadar silme iptal edilebilir.

İsteği yeniden göndermek bekleyen zamanlamayı, yeni istekten 24 saat sonra başlayan yeni bir zamanlamayla değiştirir. Bir hesabın yalnız bir bekleyen silmesi olabilir. Geçerli zamanlama kullanıcı nesnesinde pending_bulk_message_deletion olarak ve Toplu mesaj silme durumunu al ile gösterilir.

JSON gövdesi (sudo doğrulaması)¶

Yukarıdaki yoldan farklı olarak bu yol sudo'yu istek gövdesinde satır içinde denetler ve oturum sudo yetkilerini yok sayar. Tam olarak bir kanıt gönderilir:

Birden fazla alan varsa önce sudo_proof, sonra mfa_code, sonra password denetlenir.

Yanıt¶

{
  "scheduled_at": "2026-09-24T09:15:02.481+00:00",
  "message_count": 1284,
  "channel_count": 37
}

message_count ve channel_count istek yapıldığında sayılır ve zamanlama beklerken güncellenmez.

Yan etkiler¶

İsteğin kendisi hiçbir şey silmez ve Gateway olayı göndermez. Bir arka plan görevi 10 dakikada bir çalışır. scheduled_at geçtikten sonra mesajları siler, zamanlamayı temizler ve bekleyen silmeyi hesaptan kaldırır. Bu silmeler MESSAGE_DELETE olayı göndermez ve hiçbir şey istemciye silmenin bittiğini bildirmez. Bunu bilmek gerekiyorsa Toplu mesaj silme durumunu al düzenli olarak sorgulanır.

Hız sınırı¶

profile:purge kovasında kullanıcı başına saatte 3 istek. Bu sınır yalnız sudo doğrulaması başarılı olduktan sonra denetlenir. Yanlış kanıtlar ayrıca sınırlanır: kullanıcı başına mfa_code için 15 dakikada 10 deneme, password için 5 dakikada 10 deneme.

Toplu mesaj silme durumunu al¶

GET /profile/purge-status

Çağıranın bekleyen toplu silmesini döndürür. Bekleyen bir şey yoksa her alan null olur.

Toplu mesaj silmeyi iptal et¶

DELETE /profile/purge-messages

Bekleyen bir toplu mesaj silmeyi iptal eder ve 200 {"message": "..."} döndürür. Bu yol sudo doğrulaması gerektirmez. Bekleyen bir şey olmasa bile 200 döndürür. Gateway olayı göndermez. Zamanlanmış silme başladıktan sonra iptal edilecek bir şey kalmaz ve silinmiş mesajlar geri getirilemez.