Kekuatan moderasi,
dapat dipanggil dari kode Anda
Hubungkan Telm ke sistem Anda sendiri: periksa teks apa pun dengan engine anti-spam produksi, kelola pengaturan dan aturan grup dari kode, baca jurnal keputusan dan analitik — semuanya melalui REST API yang rapi dengan kunci yang Anda kendalikan.
- REST v1 yang stabil
- Pemeriksaan spam di semua paket
- Webhook sudah termasuk
Panggilan pertama Anda dalam 30 detik
Tanpa ritual SDK: cukup panggilan HTTPS dengan kunci Anda.
$ 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 vonis dari engine produksi — lengkap dengan skor dan alasan yang terpicu. Respons tiba jauh di bawah satu detik untuk pemeriksaan berbasis aturan.
Apa yang bisa dilakukan API
Pemeriksaan spam & pengguna
Jalankan teks apa pun melalui engine yang sama yang melindungi grup Telm — panggilan tunggal, batch hingga 20, dan penyaringan pengguna terhadap CAS plus dataset milik Telm sendiri.
POST /spam/checkPOST /spam/check-batchPOST /users/checkGrup & pengaturan
Baca dan patch pengaturan perlindungan, kelola aturan moderasi kustom dan whitelist — untuk satu grup atau sekumpulan grup sekaligus.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistJurnal & analitik
Baca setiap keputusan engine lengkap dengan vonis, skor, dan aturan yang terpicu, tarik rangkaian analitik harian, dan pantau penggunaan kuota Anda sendiri.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageManajemen webhook
Buat dan kelola endpoint webhook, kirim test ping, dan periksa riwayat pengiriman — sepenuhnya melalui API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesBatas yang jujur, tercetak di kemasan
| Paket | Panggilan per hari | Batas laju | Akses API |
|---|---|---|---|
| Free | 100 | 60/min | Pemeriksaan spam |
| Basic | 1 000 | 60/min | Pemeriksaan spam |
| Pro | 10 000 | 600/min | API lengkap + webhook |
| Business | 50 000 | 1 800/min | API lengkap + webhook |
Batas berlaku per akun, bukan per kunci. Setiap respons membawa header X-Quota-Limit, X-Quota-Used, dan X-Quota-Reset, dan saat mencapai batas akan mengembalikan 429 yang bersih dengan Retry-After — tanpa kejutan.
Kunci yang dibangun sebagaimana mestinya
Ditampilkan sekali, disimpan dalam bentuk hash
Kunci lengkap muncul tepat satu kali, saat dibuat. Telm hanya menyimpan hash — tidak ada seorang pun, termasuk kami, yang bisa membaca kembali kunci Anda.
Scope read/write
Kunci membawa scope read dan write. Berikan skrip pelaporan Anda kunci read-only — secara fisik kunci itu tidak bisa mengubah pengaturan apa pun.
Pencabutan instan
Cabut kunci mana pun dari dasbor dan kunci itu langsung berhenti bekerja. Sakelar darurat per akun bisa membekukan seluruh akses API sekaligus.
API lengkap dan webhook termasuk dalam Pro dan Business. Pemeriksaan spam tersedia di semua paket — termasuk Free — dalam batas kuota harian.
Engine yang sama, kini dalam kendali Anda
API publik memaparkan engine moderasi yang sama yang menjalankan bot Telm — bukan tiruan yang disederhanakan. POST sebuah teks ke /spam/check dan teks itu melewati pipeline identik yang digunakan grup Anda: sinyal reputasi, aturan, dan opsional pengklasifikasi AI. Artinya Anda bisa menyematkan penilaian Telm di mana saja: formulir dukungan, bot Anda sendiri, kolom komentar, alat internal.
Selain pemeriksaan, API mengelola grup Anda sebagai kode. Baca dan patch pengaturan perlindungan, buat aturan moderasi, kelola whitelist — operasi yang sama seperti di dasbor, tetapi bisa diskrip. Agensi yang menjalankan puluhan komunitas dapat menggulirkan perubahan kebijakan dengan satu loop alih-alih puluhan klik.
Riwayat adalah warga kelas satu: endpoint jurnal mengembalikan setiap keputusan yang dibuat engine — vonis, skor, aturan mana yang terpicu, tindakan apa yang diambil — dengan paginasi kursor yang dirancang untuk pengarsipan. Dikombinasikan dengan endpoint analitik, Anda bisa membangun arsip kepatuhan, dasbor internal, atau pemberitahuan di atas data nyata grup Anda.
Autentikasi sengaja dibuat membosankan: kunci bearer yang dibuat di dasbor Anda, ditampilkan sekali, disimpan dalam bentuk hash, dengan scope read/write dan pencabutan instan. Setiap respons membawa header kuota sehingga integrasi Anda selalu tahu posisinya.
Frequently asked questions
Which plans include API access?
Spam checking (/spam/check) works on every plan, including Free, within the daily quota. The full API — group settings, rules, journal, analytics, user screening and webhooks — is included in Pro and Business.
What are the request limits?
Daily quotas by plan: Free 100, Basic 1,000, Pro 10,000, Business 50,000 calls. Rate limits: 60 requests per minute on Free and Basic, 600 on Pro, 1,800 on Business. Every response includes X-Quota-Limit, X-Quota-Used and X-Quota-Reset headers.
How do I get an API key?
In the dashboard under Settings → API & Webhooks. The key is shown once at creation — only its hash is stored. You can hold up to 10 active keys, scope them to read-only, and revoke any of them instantly.
Can the AI classifier be used through the API?
AI checks consume the plan’s separate daily AI quota: Basic 100, Pro 1,000, Business 10,000 (Free has none).
Is there an OpenAPI specification?
Yes, the full machine-readable OpenAPI 3.1 spec is published alongside the developer documentation, so you can generate clients or plug it into your tooling.
Fitur Terkait
Jelajahi lebih banyak cara Telm dapat membantu komunitas Anda