Toplu uç nokta, tek bir POST'ta 20 metne kadar Telm anti-spam motorundan geçirir ve her biri için bir karar döndürür. Yalnızca-kurallardır (AI düzeyi yok) ve Pro planı ve üstünde kullanılabilir. Kota öğe başına ücretlendirilir, dolayısıyla on metinlik bir toplu iş on çağrı harcar. İsteğe bağlı bir AI kontrolüyle tek bir metin için, normal spam kontrol uç noktasını kullanın.
1Toplu spam kontrolü ne yapar
Toplu spam kontrolü, mesaj başına bir istek yapmak yerine birçok metni aynı anda puanlamanızı sağlar. Bir öğe dizisiyle /spam/check-batch adresine bir POST gönderirsiniz ve aynı sırada bir kararlar dizisi geri alırsınız — bir mesaj birikimini sınıflandırmak, bir yorum akışını denetlemek veya bir örneklem üzerinde tespit kalitesini değerlendirmek için idealdir.
Toplu iş, canlı grupları koruyan aynı kurallar motorunu çalıştırır, ancak her isteği hızlı ve öngörülebilir tutan AI düzeyini çalıştırmaz. AI kontrolüne ihtiyacınız varsa, tek seferde bir metin olacak şekilde AI seçeneği etkinleştirilmiş tek spam kontrol uç noktasını kullanın.
- Uç nokta: POST /api/public/v1/spam/check-batch.
- İstek başına 20 metne kadar puanlar, kararlar giriş sırasında döndürülür.
- Yalnızca-kurallar: AI düzeyi toplu modda çalıştırılmaz.
2İstek biçimi
İstek gövdesi, bir items dizisine sahip bir JSON nesnesidir. Her öğenin zorunlu bir text alanı ve canlı motorun gördüğünü yansıtan isteğe bağlı bir context nesnesi vardır — group_id, gönderenin user_telegram_id'si, gönderenin yeni bir kullanıcı olup olmadığı, username ve allow_sales ile crypto_community gibi bayraklar.
Bir öğe context'inde bir group_id içerdiğinde, kontrol o grubun özel kurallarını ve ayarlarını uygular, dolayısıyla hesabınızın o grubun yöneticisi olması gerekir, aksi halde tüm istek reddedilir. Bunun yerine küresel kural kümesine karşı puanlamak için grup context'ini atlayın.
- Üst düzey alan: items — bir ile yirmi girdi arasında bir dizi.
- Her öğe: text (zorunlu) ve isteğe bağlı bir context nesnesi.
- Context şunları taşıyabilir: group_id, user_telegram_id, is_new_user, username, allow_sales, crypto_community.
- Bir grup context'i, o grubu yönetmenizi gerektirir.
3Yanıt biçimi
Yanıt, bir results dizisi — giriş öğesi başına bir karar, aynı sırada — ve kullanılan sayınızı, günlük limitinizi ve sıfırlama zamanınızı gösteren bir quota nesnesi olan bir JSON nesnesidir.
Her karar size sınıflandırmayı ve nedenini söyler. verdict alanı spam, suspicious veya clean değerlerinden biridir. Onun yanında sayısal bir score ve confidence, bir recommended_action (none, review, warn, mute, kick, ban veya delete değerlerinden biri), bir categories listesi, insan tarafından okunabilir reasons, eşleşen matched_rules adları ve bireysel puanlama katkılarını içeren bir signals eşlemesi alırsınız.
- results — öğe başına bir karar, giriş sırasında.
- verdict — spam, suspicious veya clean.
- Her kararın ayrıca score, confidence, recommended_action, categories, reasons, matched_rules ve signals değerleri vardır.
- quota — gövdede yansıtılan used, limit ve reset_at.
4Limitler ve kota maliyeti
Bir toplu iş, istek başına 20 öğe ile sınırlıdır ve her metin 10.000 karakterle sınırlıdır. Tüm istek gövdesinin de bir boyut tavanı vardır, dolayısıyla çok büyük yükler işlenmeden önce reddedilir. 20'den fazla metniniz varsa, bunları birkaç isteğe bölün.
Kota istek başına değil öğe başına ücretlendirilir: on metinlik bir toplu iş, günlük kotanızdan on çağrı harcar. Bu, API oran limitleri ve kotalar bölümünde açıklanan aynı bütçedir ve yanıt, olağan X-Quota-Limit, X-Quota-Used ve X-Quota-Reset başlıklarını taşır.
- İstek başına 20 öğeye kadar; metin başına 10.000 karaktere kadar.
- Kota maliyeti, toplu işteki öğe sayısına eşittir.
- Standart X-Quota-* başlıkları uygulanır, ayrıca gövdede bir quota nesnesi.
5Hatalar ve zaman aşımları
Hatalı istekler belirli bir kodla 400 döndürür: boş bir items dizisi, öğe limitini aşan bir toplu iş, eksik bir text veya uzunluk limitini aşan bir text. Yönetmediğiniz bir grup context'i, o öğe için 404 döndürür. Pro altındaki bir plan, bir plan_required koduyla 403 döndürür.
Bir toplu işin işlenmesi zaman bütçesini aşarsa, API 504 döndürür ve bitirmediği öğeler için kotayı iade eder, dolayısıyla yalnızca tamamlanan iş için ücretlendirilirsiniz. Zaman aşımları görürseniz, daha küçük toplu işler gönderin.
- 400 — empty_batch, batch_too_large, missing_text veya text_too_long.
- 404 — bir öğe context'indeki bir grup, yönettiğiniz bir grup değil.
- 403 plan_required — toplu uç nokta Pro veya üstünü gerektirir.
- 504 zaman aşımı — toplu iş çok uzun sürdü; bitmemiş öğeler iade edilir. Daha az metin gönderin.