Kuasa moderasi,
boleh dipanggil daripada kod anda
Sambungkan Telm ke dalam sistem anda sendiri: semak sebarang teks dengan enjin anti-spam produksi, urus tetapan dan peraturan kumpulan daripada kod, baca jurnal keputusan dan analitik — semuanya melalui REST API yang kemas dengan kunci yang anda kawal.
- REST v1 yang stabil
- Semakan spam pada setiap pelan
- Webhook disertakan
Panggilan pertama anda dalam 30 saat
Tiada kerumitan SDK: panggilan HTTPS dengan kunci anda sudah memadai.
$ curl -X POST https://api.telm.com/api/public/v1/spam/check \
-H "Authorization: Bearer tk_live_..." \
-d '{"text": "Earn $500/day from home!! DM me now"}'
// HTTP 200
{
"verdict": "spam",
"score": 97,
"reasons": ["contact_flow", "money_lure"]
}Satu permintaan, satu verdik daripada enjin produksi — berserta skor dan sebab-sebab yang dicetuskan. Respons tiba dalam masa kurang daripada satu saat untuk semakan berasaskan peraturan.
Apa yang boleh dilakukan oleh API
Semakan spam & pengguna
Jalankan sebarang teks melalui enjin yang sama yang melindungi kumpulan Telm — panggilan tunggal, kelompok sehingga 20, dan penyaringan pengguna terhadap CAS serta set data milik Telm sendiri.
POST /spam/checkPOST /spam/check-batchPOST /users/checkKumpulan & tetapan
Baca dan patch tetapan perlindungan, urus peraturan moderasi tersuai dan senarai putih — untuk satu kumpulan atau seluruh armada.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistJurnal & analitik
Baca setiap keputusan enjin berserta verdik, skor dan peraturan yang dicetuskan, tarik siri analitik harian, dan jejaki penggunaan kuota anda sendiri.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usagePengurusan webhook
Cipta dan urus titik akhir webhook, hantar ping ujian dan periksa sejarah penghantaran — sepenuhnya melalui API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesHad yang jujur, tercetak pada kotak
| Pelan | Panggilan sehari | Had kadar | Akses API |
|---|---|---|---|
| Free | 100 | 60/min | Semakan spam |
| Pro | 10 000 | 600/min | API penuh + webhook |
| Business | 50 000 | 1 800/min | API penuh + webhook |
Had dikenakan bagi setiap akaun, bukan bagi setiap kunci. Setiap respons membawa pengepala X-Quota-Limit, X-Quota-Used dan X-Quota-Reset, dan apabila had dicapai ia memulangkan 429 yang kemas dengan Retry-After — tiada kejutan.
Kunci yang dibina sebagaimana yang sepatutnya
Dipapar sekali, disimpan dalam bentuk hash
Kunci penuh muncul tepat sekali sahaja, semasa dicipta. Telm hanya menyimpan hash — tiada sesiapa, termasuk kami, boleh membaca semula kunci anda.
Skop baca/tulis
Kunci membawa skop baca dan tulis. Berikan skrip pelaporan anda kunci baca sahaja — ia secara fizikal tidak boleh mengubah sebarang tetapan.
Pembatalan serta-merta
Batalkan mana-mana kunci daripada papan pemuka dan ia berhenti berfungsi dengan serta-merta. Suis pemati bagi setiap akaun boleh membekukan semua akses API sekali gus.
API penuh dan webhook disertakan dalam Pro dan Business. Semakan spam tersedia pada setiap pelan — termasuk Free — dalam had kuota harian.
Enjin yang sama, kini di bawah kawalan anda
API awam mendedahkan enjin moderasi yang sama yang menjalankan bot Telm — bukan tiruan yang dipermudah. POST satu teks ke /spam/check dan ia melalui saluran yang sama seperti yang digunakan oleh kumpulan anda: isyarat reputasi, peraturan, dan secara pilihan pengelas AI. Ini bermakna anda boleh membenamkan pertimbangan Telm di mana-mana sahaja: borang sokongan, bot anda sendiri, ruangan komen, atau alat dalaman.
Selain semakan, API menguruskan kumpulan anda sebagai kod. Baca dan patch tetapan perlindungan, cipta peraturan moderasi, kekalkan senarai putih — operasi yang sama seperti papan pemuka, tetapi boleh diskrip. Agensi yang mengendalikan berpuluh-puluh komuniti boleh melancarkan perubahan dasar dengan satu gelung dan bukannya berpuluh-puluh klik.
Sejarah ialah keutamaan utama: titik akhir jurnal memulangkan setiap keputusan yang dibuat oleh enjin — verdik, skor, peraturan mana yang dicetuskan, tindakan yang diambil — dengan penomboran kursor yang dibina untuk pengarkiban. Digabungkan dengan titik akhir analitik, anda boleh membina arkib pematuhan, papan pemuka dalaman atau pemberitahuan amaran berdasarkan data sebenar kumpulan anda.
Pengesahan sengaja dibuat membosankan: kunci bearer yang dicipta dalam papan pemuka anda, dipaparkan sekali sahaja, disimpan dalam bentuk hash, dengan skop baca/tulis dan pembatalan serta-merta. Setiap respons membawa pengepala kuota supaya integrasi anda sentiasa tahu kedudukannya.
Soalan lazim
Pelan manakah yang merangkumi akses API?
Semakan spam (/spam/check) berfungsi pada setiap pelan, termasuk Free, dalam had kuota harian. API penuh — tetapan kumpulan, peraturan, jurnal, analitik, saringan pengguna dan webhook — disertakan dalam Pro dan Business.
Apakah had permintaannya?
Kuota harian mengikut pelan: Free 100, Pro 10,000, Business 50,000 panggilan. Had kadar: 60 permintaan seminit pada Free, 600 pada Pro, 1,800 pada Business. Setiap respons menyertakan pengepala X-Quota-Limit, X-Quota-Used dan X-Quota-Reset.
Bagaimanakah saya mendapatkan kunci API?
Dalam papan pemuka, di bawah Tetapan → API & Webhook. Kunci hanya dipaparkan sekali semasa dicipta — hanya hash-nya disimpan. Anda boleh memegang sehingga 10 kunci aktif, mengehadkannya kepada baca sahaja, dan membatalkan mana-mana kunci serta-merta.
Bolehkah pengelas AI digunakan melalui API?
Ya, pada Pro dan Business: tambah include_ai pada permintaan /spam/check dan setiap semakan AI menggunakan peruntukan API harian yang berasingan — 1,000 pada Pro, 10,000 pada Business. Pada Free, semakan spam melalui API hanya berasaskan peraturan. Peruntukan ini hanya untuk panggilan API: moderasi AI dalam kumpulan Telegram anda disertakan dalam setiap pelan.
Adakah terdapat spesifikasi OpenAPI?
Ya, spesifikasi OpenAPI 3.1 penuh yang boleh dibaca mesin diterbitkan bersama dokumentasi pembangun, jadi anda boleh menjana klien atau menyambungkannya ke alatan anda.
Ciri-ciri Berkaitan
Terokai lebih banyak cara Telm boleh membantu komuniti anda