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 |
| Basic | 1 000 | 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 inkluderar API-åtkomst?
Spamkontroll (/spam/check) fungerar i alla planer, inklusive Free, inom den dagliga kvoten. Hela API:et — gruppinställningar, regler, logg, analys, användarkontroll och webhooks — ingår i Pro och Business.
Vilka är förfrågningsgränserna?
Dagliga kvoter per plan: Free 100, Basic 1 000, Pro 10 000, Business 50 000 anrop. Hastighetsgränser: 60 förfrågningar per minut på Free och Basic, 600 på Pro, 1 800 på Business. Varje svar innehåller headerna X-Quota-Limit, X-Quota-Used och X-Quota-Reset.
Hur får jag en API-nyckel?
I panelen under Inställningar → API & Webhooks. Nyckeln visas en gång vid skapandet — endast dess hash lagras. Du kan ha upp till 10 aktiva nycklar, begränsa dem till skrivskyddade och återkalla vilken som helst av dem omedelbart.
Kan AI-klassificeraren användas via API:et?
Ja — skicka med include_ai i /spam/check så lägger svaret till AI-utlåtandet. AI-kontroller hämtas från en separat daglig AI-kvot som är tillgänglig i Pro och Business.
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 din verktygskedja.
Där team använder detta
Verkliga gemenskapstyper där den här funktionen gör grovjobbet.
Professionell moderering för företagsgrupper och kundgemenskaper. Starkt skydd med detaljerade revisionsloggar.
Håll supportkanaler rena från spam samtidigt som nya användare får ställa frågor. Supportläge gör onboarding enkelt.
Skydda din kryptogrupp från bedragare, falska airdrops och phishing-länkar — inklusive bedrägerier gömda inuti bilder.
Relaterade funktioner
Utforska fler sätt som Telm kan hjälpa din gemenskap