Putere de moderare,
apelabilă din codul tău
Conectează Telm în propriile tale sisteme: verifică orice text cu motorul anti-spam de producție, gestionează setările și regulile grupurilor din cod, citește registrul de decizii și analiza — totul printr-o API REST curată, cu chei pe care le controlezi.
- REST v1 stabilă
- Verificare spam pe orice plan
- Webhook-uri incluse
Primul tău apel în 30 de secunde
Fără ceremonie de SDK: un apel HTTPS cu cheia ta este tot ce trebuie.
$ 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"]
}O cerere, un verdict de la motorul de producție — cu un scor și motivele care s-au declanșat. Răspunsul sosește în mult sub o secundă pentru verificările bazate pe reguli.
Ce poate face API-ul
Verificări de spam și utilizatori
Treci orice text prin același motor care protejează grupurile Telm — apeluri individuale, loturi de până la 20 și verificarea utilizatorilor față de CAS plus setul de date propriu al Telm.
POST /spam/checkPOST /spam/check-batchPOST /users/checkGrupuri și setări
Citește și modifică setările de protecție, gestionează reguli de moderare personalizate și lista albă — pentru un singur grup sau o flotă întreagă.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistRegistru și analiză
Citește fiecare decizie a motorului cu verdict, scor și regulile declanșate, extrage serii de analiză zilnice și urmărește-ți propriul consum de cotă.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageGestionarea webhook-urilor
Creează și gestionează endpoint-uri de webhook, trimite ping-uri de test și inspectează istoricul livrărilor — în întregime prin API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesLimite oneste, scrise pe cutie
| Plan | Apeluri pe zi | Limită de rată | Acces API |
|---|---|---|---|
| Free | 100 | 60/min | Verificare spam |
| Basic | 1 000 | 60/min | Verificare spam |
| Pro | 10 000 | 600/min | API complet + webhook-uri |
| Business | 50 000 | 1 800/min | API complet + webhook-uri |
Limitele se aplică per cont, nu per cheie. Fiecare răspuns poartă anteturile X-Quota-Limit, X-Quota-Used și X-Quota-Reset, iar atingerea unei limite returnează un 429 curat cu Retry-After — fără surprize.
Chei construite așa cum trebuie
Afișată o dată, stocată ca hash
Cheia completă apare exact o dată, la creare. Telm stochează doar un hash — nimeni, inclusiv noi, nu îți poate citi cheia înapoi.
Domenii de citire/scriere
Cheile poartă domenii de citire și scriere. Dă-i scriptului tău de raportare o cheie doar-citire — fizic nu poate modifica nicio setare.
Revocare instantanee
Revocă orice cheie din panou și ea încetează să funcționeze imediat. Un întrerupător de urgență per cont poate îngheța tot accesul la API dintr-o dată.
API-ul complet și webhook-urile sunt incluse în Pro și Business. Verificarea spamului este disponibilă pe orice plan — inclusiv Free — în limita cotei zilnice.
Același motor, acum sub controlul tău
API-ul public expune același motor de moderare care rulează botul Telm — nu o imitație simplificată. Trimiți un text prin POST către /spam/check și acesta parcurge exact același flux pe care îl folosesc grupurile tale: semnale de reputație, reguli și, opțional, clasificatorul AI. Asta înseamnă că poți încorpora judecata Telm oriunde: un formular de suport, propriul tău bot, o secțiune de comentarii, un instrument intern.
Dincolo de verificări, API-ul îți gestionează grupurile ca pe cod. Citește și modifică setările de protecție, creează reguli de moderare, întreține liste albe — aceleași operațiuni ca în panou, dar programabile. Agențiile care administrează zeci de comunități pot aplica o schimbare de politică printr-o singură buclă, în loc de zeci de clicuri.
Istoricul este de prim rang: endpoint-ul registrului returnează fiecare decizie luată de motor — verdict, scor, ce reguli s-au declanșat, ce acțiune s-a aplicat — cu paginare pe cursor, construită pentru arhivare. Combinat cu endpoint-ul de analiză, poți construi arhive de conformitate, tablouri de bord interne sau alerte peste datele reale ale grupului tău.
Autentificarea este intenționat plictisitoare: chei de tip bearer create în panoul tău, afișate o singură dată, stocate ca hash, cu domenii de citire/scriere și revocare instantanee. Fiecare răspuns poartă anteturi de cotă, așa că integrarea ta știe mereu unde se află.
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.
Funcții conexe
Explorați mai multe moduri în care Telm vă poate ajuta comunitatea