Titik akhir berkelompok menjalankan sehingga 20 teks melalui enjin anti-spam Telm dalam satu POST, memulangkan satu keputusan untuk setiap satu. Ia berasaskan peraturan sahaja (tiada tahap AI) dan tersedia pada pelan Pro ke atas. Kuota dicaj setiap item, jadi kelompok sepuluh teks membelanjakan sepuluh panggilan. Untuk satu teks dengan semakan AI pilihan, gunakan titik akhir semakan spam biasa.
1Apa yang dilakukan semakan spam berkelompok
Semakan spam berkelompok membolehkan anda memberi skor banyak teks sekali gus dan bukannya membuat satu permintaan setiap mesej. Anda menghantar POST ke /spam/check-batch dengan tatasusunan item dan mendapat semula tatasusunan keputusan dalam susunan yang sama — sesuai untuk mengklasifikasikan tunggakan mesej, memoderasi suapan komen, atau menilai kualiti pengesanan pada sampel.
Kelompok menjalankan enjin peraturan yang sama yang melindungi kumpulan langsung, tetapi ia tidak menjalankan tahap AI, yang memastikan setiap permintaan pantas dan boleh diramal. Jika anda memerlukan semakan AI, gunakan titik akhir semakan spam tunggal dengan pilihan AI didayakan, satu teks pada satu masa.
- Titik akhir: POST /api/public/v1/spam/check-batch.
- Memberi skor sehingga 20 teks setiap permintaan, keputusan dipulangkan dalam susunan input.
- Berasaskan peraturan sahaja: tahap AI tidak dijalankan dalam mod berkelompok.
2Format permintaan
Badan permintaan ialah objek JSON dengan tatasusunan items. Setiap item mempunyai medan text yang diperlukan dan objek context pilihan yang mencerminkan apa yang dilihat enjin langsung — group_id, penghantar user_telegram_id, sama ada penghantar ialah pengguna baharu, username, dan bendera seperti allow_sales dan crypto_community.
Apabila item merangkumi group_id dalam context-nya, semakan menggunakan peraturan tersuai dan tetapan kumpulan itu, jadi akaun anda mesti menjadi pentadbir kumpulan itu atau keseluruhan permintaan ditolak. Tinggalkan konteks kumpulan untuk memberi skor terhadap set peraturan global sebaliknya.
- Medan peringkat atas: items — tatasusunan satu hingga dua puluh entri.
- Setiap item: text (diperlukan) dan objek context pilihan.
- Konteks boleh membawa group_id, user_telegram_id, is_new_user, username, allow_sales, crypto_community.
- Konteks kumpulan memerlukan anda mentadbir kumpulan itu.
3Format respons
Respons ialah objek JSON dengan tatasusunan results — satu keputusan setiap item input, dalam susunan yang sama — dan objek quota yang menunjukkan kiraan guna anda, had harian, dan masa penetapan semula.
Setiap keputusan memberitahu anda klasifikasi dan sebabnya. Medan verdict ialah salah satu daripada spam, suspicious atau clean. Bersamanya anda mendapat skor berangka dan confidence, satu recommended_action (salah satu daripada none, review, warn, mute, kick, ban atau delete), senarai categories, sebab boleh dibaca manusia, nama matched_rules, dan peta signals dengan sumbangan pemarkahan individu.
- results — satu keputusan setiap item, dalam susunan input.
- verdict — spam, suspicious atau clean.
- Setiap keputusan juga mempunyai score, confidence, recommended_action, categories, reasons, matched_rules dan signals.
- quota — used, limit dan reset_at, turut disertakan dalam badan.
4Had dan kos kuota
Kelompok dihadkan kepada 20 item setiap permintaan, dan setiap teks dihadkan kepada 10,000 aksara. Keseluruhan badan permintaan mempunyai siling saiz juga, jadi muatan yang sangat besar ditolak sebelum diproses. Jika anda mempunyai lebih daripada 20 teks, pecahkannya merentas beberapa permintaan.
Kuota dicaj setiap item, bukan setiap permintaan: kelompok sepuluh teks membelanjakan sepuluh panggilan daripada kuota harian anda. Ini ialah bajet yang sama seperti yang diterangkan dalam had kadar dan kuota API, dan respons membawa pengepala X-Quota-Limit, X-Quota-Used dan X-Quota-Reset yang biasa.
- Sehingga 20 item setiap permintaan; sehingga 10,000 aksara setiap teks.
- Kos kuota sama dengan bilangan item dalam kelompok.
- Pengepala X-Quota-* standard terpakai, ditambah objek quota dalam badan.
5Ralat dan masa tamat
Permintaan buruk memulangkan 400 dengan kod tertentu: tatasusunan items kosong, kelompok melebihi had item, text yang hilang, atau teks melebihi had panjang. Konteks kumpulan yang anda tidak tadbir memulangkan 404 untuk item itu. Pelan di bawah Pro memulangkan 403 dengan kod plan_required.
Jika memproses kelompok melebihi bajet masanya, API memulangkan 504 dan membayar balik kuota untuk item yang tidak selesai, jadi anda hanya dicaj untuk kerja yang selesai. Jika anda melihat masa tamat, hantar kelompok yang lebih kecil.
- 400 — empty_batch, batch_too_large, missing_text atau text_too_long.
- 404 — kumpulan dalam konteks item bukan salah satu yang anda tadbir.
- 403 plan_required — titik akhir berkelompok memerlukan Pro atau lebih tinggi.
- 504 masa tamat — kelompok berjalan terlalu lama; item yang tidak selesai dibayar balik. Hantar lebih sedikit teks.