batch endpoint एक ही POST में 20 तक टेक्स्ट को Telm anti-spam इंजन से गुज़ारता है, हर एक के लिए एक फ़ैसला लौटाते हुए। यह केवल-नियम है (कोई AI स्तर नहीं) और Pro प्लान व ऊपर पर उपलब्ध। कोटा प्रति आइटम चार्ज होता है, इसलिए दस टेक्स्ट का एक batch दस कॉल ख़र्च करता है। एक वैकल्पिक AI जाँच वाले किसी एकल टेक्स्ट के लिए, सामान्य spam-check endpoint उपयोग करें।
1Batch spam check क्या करता है
Batch spam check आपको प्रति संदेश एक अनुरोध करने के बजाय एक साथ कई टेक्स्ट स्कोर करने देता है। आप आइटम की एक array के साथ /spam/check-batch को एक POST भेजते हैं और उसी क्रम में फ़ैसलों की एक array वापस पाते हैं — संदेशों के बैकलॉग को वर्गीकृत करने, किसी टिप्पणी फ़ीड को मॉडरेट करने, या किसी नमूने पर पहचान गुणवत्ता का मूल्यांकन करने के लिए आदर्श।
Batch वही नियम इंजन चलाता है जो live ग्रुपों की रक्षा करता है, पर यह AI स्तर नहीं चलाता, जो हर अनुरोध को तेज़ और पूर्वानुमेय रखता है। यदि आपको AI जाँच चाहिए, तो एक बार में एक टेक्स्ट, AI विकल्प चालू के साथ एकल spam-check endpoint उपयोग करें।
- Endpoint: POST /api/public/v1/spam/check-batch।
- प्रति अनुरोध 20 तक टेक्स्ट स्कोर करता है, फ़ैसले input क्रम में लौटाए जाते हैं।
- केवल-नियम: batch मोड में AI स्तर नहीं चलाया जाता।
2अनुरोध प्रारूप
अनुरोध body एक items array वाला एक JSON ऑब्जेक्ट है। हर आइटम में एक आवश्यक text फ़ील्ड और एक वैकल्पिक context ऑब्जेक्ट होता है जो उसे दर्पण करता है जो live इंजन देखता है — group_id, भेजने वाले की user_telegram_id, भेजने वाला नया उपयोगकर्ता है या नहीं, username, और allow_sales व crypto_community जैसे झंडे।
जब किसी आइटम के context में एक group_id शामिल हो, तो जाँच उस ग्रुप के कस्टम नियम और सेटिंग्स लागू करती है, इसलिए आपके खाते को उस ग्रुप का एडमिन होना चाहिए वरना पूरा अनुरोध अस्वीकार हो जाता है। इसके बजाय वैश्विक ruleset के विरुद्ध स्कोर करने के लिए ग्रुप context छोड़ दें।
- शीर्ष-स्तर फ़ील्ड: items — एक से बीस प्रविष्टियों की एक array।
- हर आइटम: text (आवश्यक) और एक वैकल्पिक context ऑब्जेक्ट।
- Context group_id, user_telegram_id, is_new_user, username, allow_sales, crypto_community ले जा सकता है।
- एक ग्रुप context के लिए आवश्यक है कि आप उस ग्रुप का प्रशासन करें।
3प्रतिक्रिया प्रारूप
प्रतिक्रिया एक results array वाला एक JSON ऑब्जेक्ट है — प्रति input आइटम एक फ़ैसला, उसी क्रम में — और एक quota ऑब्जेक्ट जो आपकी used गिनती, दैनिक सीमा, और रीसेट समय दिखाता है।
हर फ़ैसला आपको वर्गीकरण और कारण बताता है। verdict फ़ील्ड spam, suspicious या clean में से एक है। इसके साथ आपको एक संख्यात्मक score और confidence, एक recommended_action (none, review, warn, mute, kick, ban या delete में से एक), categories की एक सूची, मानव-पठनीय reasons, matched_rules के नाम, और अलग-अलग स्कोरिंग योगदानों वाला एक signals मानचित्र मिलता है।
- results — प्रति आइटम एक फ़ैसला, input क्रम में।
- verdict — spam, suspicious या clean।
- हर फ़ैसले में score, confidence, recommended_action, categories, reasons, matched_rules और signals भी होते हैं।
- quota — used, limit और reset_at, body में दोहराया गया।
4सीमाएँ और कोटा लागत
एक batch प्रति अनुरोध 20 आइटम पर सीमित है, और हर टेक्स्ट 10,000 अक्षरों तक सीमित है। पूरे अनुरोध body की भी एक आकार छत है, इसलिए बहुत बड़े payload प्रसंस्करण से पहले अस्वीकार कर दिए जाते हैं। यदि आपके पास 20 से अधिक टेक्स्ट हैं, तो उन्हें कई अनुरोधों में बाँटें।
कोटा प्रति आइटम चार्ज होता है, प्रति अनुरोध नहीं: दस टेक्स्ट का एक batch आपके दैनिक कोटा से दस कॉल ख़र्च करता है। यह वही बजट है जो API rate limits और कोटा में वर्णित है, और प्रतिक्रिया सामान्य X-Quota-Limit, X-Quota-Used और X-Quota-Reset headers ले जाती है।
- प्रति अनुरोध 20 तक आइटम; प्रति टेक्स्ट 10,000 अक्षर तक।
- कोटा लागत batch में आइटम की संख्या के बराबर है।
- मानक X-Quota-* headers लागू होते हैं, साथ ही body में एक quota ऑब्जेक्ट।
5त्रुटियाँ और timeouts
ख़राब अनुरोध एक विशिष्ट कोड के साथ 400 लौटाते हैं: एक ख़ाली items array, आइटम सीमा से ऊपर एक batch, एक गुम text, या लंबाई सीमा से ऊपर एक text। जिस ग्रुप का आप प्रशासन नहीं करते उसका context उस आइटम के लिए 404 लौटाता है। Pro से नीचे एक प्लान एक plan_required कोड के साथ 403 लौटाता है।
यदि किसी batch का प्रसंस्करण उसके समय बजट से अधिक हो जाए, तो API 504 लौटाता है और जो आइटम इसने पूरे नहीं किए उनके लिए कोटा वापस कर देता है, इसलिए आपसे केवल पूरे हुए काम के लिए चार्ज होता है। यदि आप timeouts देखें, तो छोटे batch भेजें।
- 400 — empty_batch, batch_too_large, missing_text या text_too_long।
- 404 — किसी आइटम context में एक ग्रुप जिसका आप प्रशासन नहीं करते।
- 403 plan_required — batch endpoint को Pro या उच्चतर चाहिए।
- 504 timeout — batch बहुत लंबा चला; अधूरे आइटम वापस किए जाते हैं। कम टेक्स्ट भेजें।