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 |
| 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ă.
Întrebări frecvente
Ce planuri includ acces la API?
Verificarea spamului (/spam/check) funcționează pe orice plan, inclusiv Free, în limita cotei zilnice. API-ul complet — setările grupului, regulile, jurnalul, analizele, verificarea utilizatorilor și webhook-urile — este inclus în Pro și Business.
Care sunt limitele de cereri?
Cote zilnice în funcție de plan: Free 100, Pro 10.000, Business 50.000 de apeluri. Limite de frecvență: 60 de cereri pe minut pe Free, 600 pe Pro, 1.800 pe Business. Fiecare răspuns include antetele X-Quota-Limit, X-Quota-Used și X-Quota-Reset.
Cum obțin o cheie API?
Din panou, la Settings → API & Webhooks. Cheia este afișată o singură dată, la creare — se stochează doar hash-ul ei. Poți avea până la 10 chei active, le poți limita la acces doar pentru citire și poți revoca oricare dintre ele instantaneu.
Poate fi folosit clasificatorul AI prin API?
Da, pe Pro și Business: adaugă include_ai la o cerere /spam/check, iar fiecare verificare AI consumă o cotă API zilnică separată — 1.000 pe Pro, 10.000 pe Business. Pe Free, verificările de spam prin API folosesc doar reguli. Această cotă acoperă doar apelurile API: moderarea AI din grupurile tale de Telegram este inclusă în orice plan.
Există o specificație OpenAPI?
Da, specificația completă OpenAPI 3.1, citibilă de mașini, este publicată alături de documentația pentru dezvoltatori, așa că poți genera clienți sau o poți conecta la instrumentele tale.
Funcții conexe
Explorați mai multe moduri în care Telm vă poate ajuta comunitatea