Modereringskraft,
anropbar från din kod
Koppla in Telm i dina egna system: kontrollera vilken text som helst med produktionens antispam-motor, hantera gruppinställningar och regler från kod, läs beslutsloggen och analysen — allt via ett rent REST API med nycklar du kontrollerar.
- Stabil REST v1
- Spamkontroll i alla planer
- Webhooks ingår
Ditt första anrop på 30 sekunder
Inget SDK-krångel: ett HTTPS-anrop med din nyckel är allt som krävs.
$ 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"]
}En förfrågan, ett utlåtande från produktionsmotorn — med en poäng och skälen som utlöstes. Svaret kommer på klart under en sekund för regelbaserade kontroller.
Vad API:et kan göra
Spam- & användarkontroller
Kör vilken text som helst genom samma motor som skyddar Telm-grupper — enskilda anrop, batchar upp till 20 och användarkontroll mot CAS plus Telms eget dataset.
POST /spam/checkPOST /spam/check-batchPOST /users/checkGrupper & inställningar
Läs och patcha skyddsinställningar, hantera egna modereringsregler och vitlistan — för en grupp eller en hel flotta.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistLogg & analys
Läs varje motorbeslut med utlåtande, poäng och utlösta regler, hämta dagliga analysserier och håll koll på din egen kvotförbrukning.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageWebhooks-hantering
Skapa och hantera webhook-endpoints, skicka test-pingar och granska leveranshistoriken — helt via API:et.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesÄrliga gränser, tryckta på förpackningen
| Plan | Anrop per dag | Hastighetsgräns | API-åtkomst |
|---|---|---|---|
| Free | 100 | 60/min | Spamkontroll |
| Pro | 10 000 | 600/min | Hela API:et + webhooks |
| Business | 50 000 | 1 800/min | Hela API:et + webhooks |
Gränserna gäller per konto, inte per nyckel. Varje svar bär headerna X-Quota-Limit, X-Quota-Used och X-Quota-Reset, och när en gräns nås returneras en ren 429 med Retry-After — inga överraskningar.
Nycklar byggda som de borde vara
Visas en gång, lagras hashad
Den fullständiga nyckeln visas exakt en gång, vid skapandet. Telm lagrar bara en hash — ingen, inte ens vi, kan läsa tillbaka din nyckel.
Läs-/skrivbehörigheter
Nycklar bär läs- och skrivbehörigheter. Ge ditt rapporteringsskript en skrivskyddad nyckel — den kan fysiskt inte ändra någon inställning.
Omedelbar återkallelse
Återkalla vilken nyckel som helst från panelen så slutar den fungera omedelbart. En kill switch per konto kan frysa all API-åtkomst på en gång.
Hela API:et och webhooks ingår i Pro och Business. Spamkontroll är tillgänglig i alla planer — inklusive Free — inom den dagliga kvoten.
Samma motor, nu under din kontroll
Det publika API:et exponerar samma modereringsmotor som driver Telms bot — ingen förenklad imitation. Skicka en text med POST till /spam/check och den går genom exakt samma pipeline som dina grupper använder: ryktessignaler, regler och valfritt AI-klassificeraren. Det betyder att du kan bädda in Telms omdöme var som helst: ett supportformulär, din egen bot, ett kommentarsfält, ett internt verktyg.
Utöver kontroller hanterar API:et dina grupper som kod. Läs och patcha skyddsinställningar, skapa modereringsregler, underhåll vitlistor — samma operationer som i panelen, men skriptbara. Byråer som driver dussintals communityn kan rulla ut en policyändring med en enda loop i stället för dussintals klick.
Historiken är förstklassig: logg-endpointen returnerar varje beslut motorn fattade — utlåtande, poäng, vilka regler som utlöstes, vilken åtgärd som vidtogs — med markörpaginering byggd för arkivering. Tillsammans med analys-endpointen kan du bygga efterlevnadsarkiv, interna paneler eller aviseringar ovanpå din grupps verkliga data.
Autentiseringen är medvetet tråkig: bearer-nycklar som du skapar i panelen, visas en gång, lagras hashade, med läs-/skrivbehörigheter och omedelbar återkallelse. Varje svar bär kvot-headers så att din integration alltid vet var den står.
Vanliga frågor
Vilka planer har API-åtkomst?
Spamkontroll (/spam/check) fungerar på alla planer, inklusive Free, inom den dagliga kvoten. Hela API:et — gruppinställningar, regler, journal, analys, användargranskning och webhooks — ingår i Pro och Business.
Vilka gränser gäller för förfrågningar?
Dagliga kvoter per plan: Free 100, Pro 10 000, Business 50 000 anrop. Hastighetsgränser: 60 förfrågningar per minut på Free, 600 på Pro, 1 800 på Business. Varje svar innehåller rubrikerna X-Quota-Limit, X-Quota-Used och X-Quota-Reset.
Hur får jag en API-nyckel?
I instrumentpanelen under Inställningar → API & Webhooks. Nyckeln visas en gång när den skapas — bara dess hash sparas. Du kan ha upp till 10 aktiva nycklar, begränsa dem till skrivskyddad åtkomst och återkalla vilken som helst av dem direkt.
Kan AI-klassificeraren användas via API:et?
Ja, på Pro och Business: lägg till include_ai i en /spam/check-förfrågan, så räknas varje AI-kontroll mot en separat daglig API-kvot — 1 000 på Pro, 10 000 på Business. På Free bygger spamkontroller via API:et bara på regler. Kvoten gäller endast API-anrop: AI-moderering i dina Telegram-grupper ingår i alla planer.
Finns det en OpenAPI-specifikation?
Ja, den fullständiga maskinläsbara OpenAPI 3.1-specifikationen publiceras tillsammans med utvecklardokumentationen, så att du kan generera klienter eller koppla in den i dina verktyg.
Relaterade funktioner
Utforska fler sätt som Telm kan hjälpa din gemenskap