endpoint เป็นชุดรันได้ถึง 20 ข้อความผ่านเอนจินป้องกันสแปมของ Telm ใน POST เดียว โดยคืนคำตัดสินสำหรับแต่ละอัน มันใช้กฎเท่านั้น (ไม่มีระดับ AI) และพร้อมใช้บนแพ็กเกจ Pro ขึ้นไป โควตาคิดต่อรายการ ดังนั้นชุดของสิบข้อความใช้สิบการเรียก สำหรับข้อความเดียวพร้อมการตรวจสอบ AI ที่เป็นตัวเลือก ให้ใช้ endpoint ตรวจสอบสแปมปกติ
1การตรวจสอบสแปมเป็นชุดทำอะไร
การตรวจสอบสแปมเป็นชุดช่วยให้คุณให้คะแนนหลายข้อความในคราวเดียวแทนที่จะทำหนึ่งคำขอต่อข้อความ คุณส่ง POST ไปยัง /spam/check-batch พร้อมอาร์เรย์ของรายการและได้รับอาร์เรย์ของคำตัดสินกลับมาในลำดับเดียวกัน — เหมาะสำหรับการจัดประเภทข้อความค้าง การดูแลฟีดคอมเมนต์ หรือการประเมินคุณภาพการตรวจจับจากตัวอย่าง
ชุดรันเอนจินกฎเดียวกันที่ปกป้องกลุ่มสด แต่ไม่รันระดับ AI ซึ่งทำให้แต่ละคำขอเร็วและคาดเดาได้ หากคุณต้องการการตรวจสอบ AI ให้ใช้endpoint ตรวจสอบสแปมเดี่ยวโดยเปิดตัวเลือก AI ทีละข้อความ
- endpoint คือ POST /api/public/v1/spam/check-batch
- ให้คะแนนได้ถึง 20 ข้อความต่อคำขอ คำตัดสินคืนในลำดับที่ป้อน
- ใช้กฎเท่านั้น คือ ระดับ AI ไม่ถูกรันในโหมดชุด
2รูปแบบคำขอ
เนื้อคำขอคืออ็อบเจกต์ JSON พร้อมอาร์เรย์ items แต่ละรายการมีฟิลด์ text ที่จำเป็นและอ็อบเจกต์ context ที่เป็นตัวเลือกซึ่งสะท้อนสิ่งที่เอนจินสดเห็น — group_id, ผู้ส่ง user_telegram_id, ผู้ส่งเป็นผู้ใช้ใหม่หรือไม่ username และแฟล็ก เช่น allow_sales และ crypto_community
เมื่อรายการรวม group_id ใน context ของมัน การตรวจสอบจะใช้กฎที่กำหนดเองและการตั้งค่าของกลุ่มนั้น ดังนั้นบัญชีของคุณต้องเป็นแอดมินของกลุ่มนั้น ไม่เช่นนั้นทั้งคำขอจะถูกปฏิเสธ ละเว้น context กลุ่มเพื่อให้คะแนนกับชุดกฎระดับสากลแทน
- ฟิลด์ระดับบนสุด คือ items — อาร์เรย์ของหนึ่งถึงยี่สิบรายการ
- แต่ละรายการ คือ text (จำเป็น) และอ็อบเจกต์ context ที่เป็นตัวเลือก
- context สามารถพก group_id, user_telegram_id, is_new_user, username, allow_sales, crypto_community
- context กลุ่มต้องการให้คุณดูแลกลุ่มนั้น
3รูปแบบการตอบกลับ
การตอบกลับคืออ็อบเจกต์ JSON พร้อมอาร์เรย์ results — หนึ่งคำตัดสินต่อรายการที่ป้อน ในลำดับเดียวกัน — และอ็อบเจกต์ quota ที่แสดงจำนวนที่ใช้ ขีดจำกัดรายวัน และเวลารีเซ็ตของคุณ
แต่ละคำตัดสินบอกคุณถึงการจัดประเภทและเหตุผล ฟิลด์ verdict เป็นหนึ่งใน spam, suspicious หรือ clean ควบคู่กับมันคุณจะได้ score และ confidence ที่เป็นตัวเลข recommended_action (หนึ่งใน none, review, warn, mute, kick, ban หรือ delete) รายการ categories เหตุผลที่คนอ่านได้ ชื่อของ matched_rules และอ็อบเจกต์ signals ที่แสดงการสมทบคะแนนของแต่ละสัญญาณ
- results — หนึ่งคำตัดสินต่อรายการ ในลำดับที่ป้อน
- verdict — spam, suspicious หรือ clean
- แต่ละคำตัดสินยังมี score, confidence, recommended_action, categories, reasons, matched_rules และ signals
- quota — used, limit และ reset_at สะท้อนในเนื้อ
4ขีดจำกัดและค่าโควตา
ชุดถูกจำกัดที่ 20 รายการต่อคำขอ และแต่ละข้อความถูกจำกัดที่ 10,000 อักขระ เนื้อคำขอทั้งหมดยังมีเพดานขนาดด้วย ดังนั้น payload ที่ใหญ่มากจะถูกปฏิเสธก่อนประมวลผล หากคุณมีมากกว่า 20 ข้อความ ให้แบ่งพวกมันข้ามหลายคำขอ
โควตาคิดต่อรายการ ไม่ใช่ต่อคำขอ คือ ชุดของสิบข้อความใช้สิบการเรียกจากโควตารายวันของคุณ นี่คืองบประมาณเดียวกับที่อธิบายในขีดจำกัดอัตราและโควตา API และการตอบกลับพกเฮดเดอร์ X-Quota-Limit, X-Quota-Used และ X-Quota-Reset ตามปกติ
- ได้ถึง 20 รายการต่อคำขอ ได้ถึง 10,000 อักขระต่อข้อความ
- ค่าโควตาเท่ากับจำนวนรายการในชุด
- เฮดเดอร์ X-Quota-* มาตรฐานใช้ได้ บวกอ็อบเจกต์ quota ในเนื้อ
5ข้อผิดพลาดและการหมดเวลา
คำขอที่ไม่ดีคืน 400 พร้อมรหัสเฉพาะ คือ อาร์เรย์ items ว่าง ชุดที่เกินขีดจำกัดรายการ text ที่ขาดหาย หรือ text ที่เกินขีดจำกัดความยาว context กลุ่มที่คุณไม่ได้ดูแลคืน 404 สำหรับรายการนั้น แพ็กเกจต่ำกว่า Pro คืน 403 พร้อมรหัส plan_required
หากการประมวลผลชุดเกินงบประมาณเวลา API จะคืน 504 และคืนโควตาสำหรับรายการที่มันทำไม่เสร็จ ดังนั้นคุณถูกคิดเฉพาะงานที่เสร็จสมบูรณ์ หากคุณเห็นการหมดเวลา ให้ส่งชุดที่เล็กลง
- 400 — empty_batch, batch_too_large, missing_text หรือ text_too_long
- 404 — กลุ่มใน context ของรายการไม่ใช่กลุ่มที่คุณดูแล
- 403 plan_required — endpoint เป็นชุดต้องการ Pro ขึ้นไป
- 504 timeout — ชุดรันนานเกินไป รายการที่ไม่เสร็จจะถูกคืนโควตา ส่งข้อความน้อยลง