Moderatiekracht,
aanroepbaar vanuit je code
Koppel Telm aan je eigen systemen: controleer willekeurige tekst met de productie-antispamengine, beheer groepsinstellingen en regels vanuit code, lees het beslissingsjournaal en de analytics — allemaal via een strakke REST API met sleutels die jij beheert.
- Stabiele REST v1
- Spamcontrole in elk plan
- Webhooks inbegrepen
Je eerste aanroep in 30 seconden
Geen SDK-poespas: een HTTPS-aanroep met je sleutel is alles wat nodig is.
$ 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"]
}Eén aanvraag, één oordeel uit de productie-engine — met een score en de redenen die afgingen. Bij op regels gebaseerde controles komt de respons ruim binnen een seconde.
Wat de API kan
Spam- & gebruikerscontroles
Stuur willekeurige tekst door dezelfde engine die Telm-groepen beschermt — losse aanroepen, batches tot 20 en gebruikerscontrole tegen CAS plus Telms eigen dataset.
POST /spam/checkPOST /spam/check-batchPOST /users/checkGroepen & instellingen
Lees en patch beveiligingsinstellingen, beheer eigen moderatieregels en de whitelist — voor één groep of een hele vloot.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistJournaal & analytics
Lees elke engine-beslissing met oordeel, score en geactiveerde regels, haal dagelijkse analyse-reeksen op en houd je eigen quotaverbruik bij.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageWebhooks-beheer
Maak en beheer webhook-endpoints, stuur test-pings en bekijk de afleverhistorie — helemaal via de API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesEerlijke limieten, gewoon op de verpakking
| Plan | Aanroepen per dag | Rate limit | API-toegang |
|---|---|---|---|
| Free | 100 | 60/min | Spamcontrole |
| Basic | 1 000 | 60/min | Spamcontrole |
| Pro | 10 000 | 600/min | Volledige API + webhooks |
| Business | 50 000 | 1 800/min | Volledige API + webhooks |
Limieten gelden per account, niet per sleutel. Elke respons draagt de headers X-Quota-Limit, X-Quota-Used en X-Quota-Reset, en bij het bereiken van een limiet komt een nette 429 met Retry-After terug — geen verrassingen.
Sleutels zoals ze horen te zijn
Eén keer getoond, gehasht opgeslagen
De volledige sleutel verschijnt precies één keer, bij het aanmaken. Telm slaat alleen een hash op — niemand, ook wij niet, kan je sleutel teruglezen.
Lees-/schrijfscopes
Sleutels dragen lees- en schrijfscopes. Geef je rapportagescript een alleen-lezen sleutel — die kan fysiek geen enkele instelling wijzigen.
Directe intrekking
Trek een willekeurige sleutel in vanuit het dashboard en die stopt onmiddellijk met werken. Een kill switch per account kan alle API-toegang in één keer bevriezen.
De volledige API en webhooks zijn inbegrepen in Pro en Business. Spamcontrole is beschikbaar in elk plan — ook in Free — binnen de dagelijkse quota.
Dezelfde engine, nu onder jouw controle
De publieke API stelt dezelfde moderatie-engine beschikbaar die de bot van Telm aandrijft — geen versimpelde imitatie. POST een tekst naar /spam/check en die doorloopt exact dezelfde pipeline als je groepen gebruiken: reputatiesignalen, regels en optioneel de AI-classificatie. Zo kun je het oordeel van Telm overal inbouwen: een supportformulier, je eigen bot, een reactiesectie, een intern tool.
Naast controles beheert de API je groepen als code. Beveiligingsinstellingen lezen en patchen, moderatieregels aanmaken, whitelists onderhouden — dezelfde handelingen als in het dashboard, maar scriptbaar. Bureaus met tientallen community's rollen een beleidswijziging uit met één loop in plaats van tientallen klikken.
Historie is eersteklas: het journaal-endpoint geeft elke beslissing van de engine terug — oordeel, score, welke regels afgingen, welke actie volgde — met cursor-paginering die gemaakt is voor archivering. Samen met het analytics-endpoint bouw je compliance-archieven, interne dashboards of alerting bovenop de echte data van je groep.
Authenticatie is bewust saai: bearer-sleutels die je in je dashboard aanmaakt, één keer getoond, gehasht opgeslagen, met lees-/schrijfscopes en directe intrekking. Elke respons draagt quota-headers, zodat je integratie altijd weet waar ze aan toe is.
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.
Gerelateerde functies
Ontdek meer manieren waarop Telm je community kan helpen