Bildirimler¶
Güvenlik bildirimi, TEBHOS moderatörlerine bir mesajın, kullanıcının veya sunucunun kuralları ihlal ettiğini bildirir. Her kullanıcı hesabı bildirim oluşturabilir. Bildirimler TEBHOS ekibi tarafından incelenir.
| İşlem | Hedef |
|---|---|
| Mesaj bildirme | Tek bir mesaj |
| Kullanıcı bildirme | Tek bir hesap; isteğe bağlı olarak bağlam için bir sunucuyla |
| Sunucu bildirme | Tek bir sunucu |
| Profil bildirimi oluşturma | Serbest metinle tek bir hesap (profil bildirme iletişim kutusu tarafından kullanılır) |
Erişim kuralları¶
Her yol bir kullanıcı oturumu gerektirir; bir bot token'ı 403 ACCESS_DENIED ile reddedilir. Hiçbir izin gerekmez ve TEBHOS, bildirenin bildirilen içeriği görüp göremediğini denetlemez.
Her bildirim bir bildirilen hesaba karşı saklanır: mesaj bildiriminde mesajın yazarı, kullanıcı bildiriminde bildirilen kullanıcı, sunucu bildiriminde ise sunucu sahibi. Gönderim hiçbir Gateway olayı göndermez.
Kategoriler sunucu tarafından doğrulanmaz
Sunucu category değerini verildiği gibi saklar. İstemciler, TEBHOS moderasyon araçlarının beklediği değerler olan aşağıda listelenen değerlerden birini göndermelidir.
TEBHOS'ta desteklenmez
Anonim Dijital Hizmetler Yasası (Digital Services Act) bildirimleri (e-posta doğrulama, destek talepleri) uygulanmamıştır; bildirimler bir hesap gerektirir. Bildirimlerde tekrar ayıklama yapılmaz ve çevredeki konuşmanın kanıt anlık görüntüsü alınmaz.
Bildirim yanıtı¶
Başarılı her gönderim 201 döndürür:
message, insanın okuyabileceği bir onaydır. Bildirim kimliği döndürülmez.
Mesaj bildirimi kategorileri¶
| Değer | Açıklama |
|---|---|
| harassment | Taciz veya zorbalık |
| hate_speech | Nefret söylemi |
| violent_content | Şiddet içeren veya rahatsız edici içerik |
| spam | Spam veya dolandırıcılık |
| nsfw_violation | Cinsel veya müstehcen içerik |
| illegal_activity | Yasa dışı etkinlik |
| doxxing | Kişisel bilgilerin paylaşılması |
| self_harm | Kendine zarar verme veya intihar |
| child_safety | Çocuk güvenliği endişeleri |
| malicious_links | Kötü amaçlı bağlantılar |
| impersonation | Kimliğe bürünme |
| other | Diğer |
Kullanıcı bildirimi kategorileri¶
| Değer | Açıklama |
|---|---|
| harassment | Taciz veya zorbalık |
| hate_speech | Nefret söylemi |
| spam_account | Spam hesabı |
| impersonation | Kimliğe bürünme |
| underage_user | Yaşı tutmayan kullanıcı |
| inappropriate_profile | Uygunsuz profil |
| other | Diğer |
Sunucu bildirimi kategorileri¶
| Değer | Açıklama |
|---|---|
| harassment | Taciz |
| hate_speech | Nefret söylemi |
| extremist_community | Aşırılıkçı topluluk |
| illegal_activity | Yasa dışı etkinlik |
| child_safety | Çocuk güvenliği endişeleri |
| raid_coordination | Baskın (raid) koordinasyonu |
| spam | Spam veya dolandırıcılık topluluğu |
| malware_distribution | Kötü amaçlı yazılım dağıtımı |
| other | Diğer |
Mesaj bildirme¶
POST /reports/message
Tek bir mesajı bildirir. Mesajın yazarı bildirilen hesap olur.
JSON gövdesi¶
| Alan | Tür | Açıklama |
|---|---|---|
| channel_id | snowflake | Mesajı içeren kanal (bağlam olarak saklanır) |
| message_id | snowflake | Bildirilen mesaj |
| category | string | Bir mesaj bildirimi kategorisi |
| description? | string | Ek bilgi (en fazla 2000 karakter) |
Yanıt¶
| Durum | Gövde | Koşul |
|---|---|---|
| 201 | bildirim yanıtı | Bildirim saklandı |
| 400 | hata yanıtı | message_id geçerli bir kimlik değil veya description 2000 karakterden uzun (BAD_REQUEST) |
| 403 | hata yanıtı | Çağıran bir bot (ACCESS_DENIED) |
| 404 | hata yanıtı | Mesaj mevcut değil (NOT_FOUND) |
Örnek¶
curl -X POST "https://tebhos.com/api/v1/reports/message" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"channel_id":"1489002177550843905","message_id":"1501314428688998190","category":"spam"}'
Kullanıcı bildirme¶
POST /reports/user
Bir hesabı bildirir.
JSON gövdesi¶
| Alan | Tür | Açıklama |
|---|---|---|
| user_id | snowflake | Bildirilen kullanıcı |
| category | string | Bir kullanıcı bildirimi kategorisi |
| guild_id? | snowflake | Davranışın gerçekleştiği sunucu |
| description? | string | Ek bilgi (en fazla 2000 karakter) |
Yanıt¶
| Durum | Gövde | Koşul |
|---|---|---|
| 201 | bildirim yanıtı | Bildirim saklandı |
| 400 | hata yanıtı | user_id geçerli bir kimlik değil veya description çok uzun (BAD_REQUEST) |
| 403 | hata yanıtı | Çağıran bir bot (ACCESS_DENIED) |
| 404 | hata yanıtı | Kullanıcı mevcut değil (NOT_FOUND) |
Sunucu bildirme¶
POST /reports/guild
Bir sunucuyu bildirir. Sunucu sahibi bildirilen hesap olur.
JSON gövdesi¶
| Alan | Tür | Açıklama |
|---|---|---|
| guild_id | snowflake | Bildirilen sunucu |
| category | string | Bir sunucu bildirimi kategorisi |
| invite_code? | string | Bildirenin sunucuyu bulduğu davet |
Yanıt¶
| Durum | Gövde | Koşul |
|---|---|---|
| 201 | bildirim yanıtı | Bildirim saklandı |
| 400 | hata yanıtı | guild_id geçerli bir kimlik değil (BAD_REQUEST) |
| 403 | hata yanıtı | Çağıran bir bot (ACCESS_DENIED) |
| 404 | hata yanıtı | Sunucu mevcut değil (NOT_FOUND) |
Profil bildirimi oluşturma¶
POST /reports
TEBHOS profil bildirme iletişim kutusunun kullandığı, bir hesaba karşı genel bir bildirim.
JSON gövdesi¶
| Alan | Tür | Açıklama |
|---|---|---|
| reported_profile_id | snowflake | Bildirilen kullanıcı |
| category | string | 1-50 karakter. Profil iletişim kutusu spam, harassment, hate_speech, impersonation veya other gönderir |
| description? | string | Ek bilgi (en fazla 2000 karakter) |
| targets? | array[string] | Profilin bildirilen bölümleri; örneğin photo, name, bio, tag. Kabul edilir ancak şu anda saklanmaz |
| attachment_url? | string | Destekleyici bir görüntü URL'si. Kabul edilir ancak şu anda saklanmaz |
Yanıt¶
| Durum | Gövde | Koşul |
|---|---|---|
| 201 | bildirim yanıtı | Bildirim saklandı |
| 400 | hata yanıtı | category veya description uzunluğu geçersiz (INVALID_FORM_BODY) ya da reported_profile_id geçerli bir kimlik değil (BAD_REQUEST) |
| 403 | hata yanıtı | Çağıran bir bot (ACCESS_DENIED) |
Hız sınırı¶
Dört yolun tümü tek bir kovayı paylaşır: report kovasında kullanıcı başına saatte 10 bildirim.