Síla moderace,
volatelná z vašeho kódu
Zapojte Telm do vlastních systémů: prověřte libovolný text produkčním antispamovým enginem, spravujte nastavení a pravidla skupin z kódu, čtěte deník rozhodnutí i analytiku — to vše přes čisté REST API s klíči, které řídíte vy.
- Stabilní REST v1
- Kontrola spamu v každém plánu
- Webhooky v ceně
Vaše první volání za 30 sekund
Žádné SDK ceremonie: stačí HTTPS volání s vaším klíčem.
$ 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"]
}Jeden požadavek, jeden verdikt z produkčního enginu — se skóre a důvody, které se spustily. U kontrol založených na pravidlech dorazí odpověď výrazně pod jednu sekundu.
Co API umí
Kontroly spamu a uživatelů
Prožeňte libovolný text stejným enginem, který chrání skupiny Telm — jednotlivá volání, dávky až po 20 a prověrku uživatelů proti CAS i vlastnímu datasetu Telm.
POST /spam/checkPOST /spam/check-batchPOST /users/checkSkupiny a nastavení
Čtěte a upravujte nastavení ochrany, spravujte vlastní pravidla moderace i whitelist — pro jednu skupinu nebo celou flotilu.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistDeník a analytika
Čtěte každé rozhodnutí enginu s verdiktem, skóre a spuštěnými pravidly, stahujte denní analytické řady a sledujte vlastní spotřebu kvóty.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageSpráva webhooků
Vytvářejte a spravujte webhookové endpointy, posílejte testovací pingy a prohlížejte historii doručení — celé přes API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesPoctivé limity, vytištěné na krabici
| Plán | Volání za den | Rate limit | Přístup k API |
|---|---|---|---|
| Free | 100 | 60/min | Kontrola spamu |
| Pro | 10 000 | 600/min | Plné API + webhooky |
| Business | 50 000 | 1 800/min | Plné API + webhooky |
Limity platí na účet, ne na klíč. Každá odpověď nese hlavičky X-Quota-Limit, X-Quota-Used a X-Quota-Reset a při dosažení limitu vrátí čistou 429 s Retry-After — žádná překvapení.
Klíče postavené tak, jak mají být
Zobrazeno jednou, uloženo jako hash
Plný klíč se objeví přesně jednou, při vytvoření. Telm ukládá pouze hash — nikdo, včetně nás, váš klíč nepřečte zpět.
Rozsahy čtení/zápis
Klíče nesou rozsahy čtení a zápis. Dejte svému reportovacímu skriptu klíč jen pro čtení — fyzicky nemůže změnit žádné nastavení.
Okamžité odvolání
Odvolejte kterýkoli klíč z dashboardu a okamžitě přestane fungovat. Nouzový vypínač pro celý účet umí naráz zmrazit veškerý přístup k API.
Plné API a webhooky jsou součástí plánů Pro a Business. Kontrola spamu je dostupná v každém plánu — včetně Free — v rámci denní kvóty.
Tentýž engine, teď pod vaší kontrolou
Veřejné API zpřístupňuje tentýž moderační engine, který pohání bota Telm — ne zjednodušenou napodobeninu. Pošlete POST s textem na /spam/check a projde identickým procesem jako vaše skupiny: signály reputace, pravidla a volitelně AI klasifikátor. Znamená to, že úsudek Telm můžete zabudovat kamkoli: do podpůrného formuláře, vlastního bota, sekce komentářů nebo interního nástroje.
Kromě kontrol API spravuje vaše skupiny jako kód. Čtěte a upravujte nastavení ochrany, vytvářejte pravidla moderace, udržujte whitelisty — stejné operace jako v dashboardu, ale skriptovatelné. Agentury spravující desítky komunit tak zavedou změnu politiky jedním cyklem místo desítek kliknutí.
Historie je prvořadá: endpoint deníku vrací každé rozhodnutí, které engine učinil — verdikt, skóre, která pravidla se spustila i jakou akci provedl — s kurzorovým stránkováním připraveným k archivaci. Ve spojení s analytickým endpointem tak nad reálnými daty své skupiny postavíte archivy pro compliance, interní dashboardy nebo alerting.
Autentizace je záměrně nudná: bearer klíče vytvořené ve vašem dashboardu, zobrazené jen jednou, uložené jako hash, s rozsahy čtení/zápis a okamžitým odvoláním. Každá odpověď nese hlavičky kvóty, takže vaše integrace vždy ví, na čem je.
Časté dotazy
Které plány zahrnují přístup k API?
Kontrola spamu (/spam/check) funguje v každém plánu, včetně Free, v rámci denní kvóty. Plné API — nastavení skupin, pravidla, deník, analytika, prověrka uživatelů a webhooky — je součástí plánů Pro a Business.
Jaké jsou limity požadavků?
Denní kvóty podle plánu: Free 100, Pro 10 000, Business 50 000 volání. Rate limity: 60 požadavků za minutu na Free, 600 na Pro, 1 800 na Business. Každá odpověď obsahuje hlavičky X-Quota-Limit, X-Quota-Used a X-Quota-Reset.
Jak získám API klíč?
V dashboardu v části Nastavení → API a Webhooky. Klíč se zobrazí jen jednou, při vytvoření — ukládá se pouze jeho hash. Můžete mít až 10 aktivních klíčů, omezit je jen na čtení a kterýkoli z nich okamžitě odvolat.
Lze AI klasifikátor používat přes API?
Ano, v plánech Pro a Business: přidejte include_ai k požadavku /spam/check a každá AI kontrola čerpá ze samostatné denní kvóty API — 1 000 na Pro, 10 000 na Business. Na Free používají kontroly spamu přes API jen pravidla. Tato kvóta se týká pouze volání API: AI moderace přímo ve vašich telegramových skupinách je součástí každého plánu.
Existuje specifikace OpenAPI?
Ano, kompletní strojově čitelná specifikace OpenAPI 3.1 je zveřejněna spolu s dokumentací pro vývojáře, takže z ní můžete generovat klienty nebo ji zapojit do svých nástrojů.
Související funkce
Prozkoumejte další způsoby, jak vám Telm může pomoci s vaší komunitou