Moderationskraft,
aus Ihrem Code aufrufbar
Binden Sie Telm in Ihre eigenen Systeme ein: prüfen Sie beliebigen Text mit der produktiven Anti-Spam-Engine, verwalten Sie Gruppeneinstellungen und Regeln per Code, lesen Sie das Entscheidungsjournal und die Analytics — alles über eine saubere REST-API mit Schlüsseln, die Sie kontrollieren.
- Stabile REST v1
- Spam-Prüfung in jedem Tarif
- Webhooks inklusive
Ihr erster Aufruf in 30 Sekunden
Kein SDK-Zeremoniell: ein HTTPS-Aufruf mit Ihrem Schlüssel genügt.
$ 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"]
}Eine Anfrage, ein Urteil aus der produktiven Engine — mit einem Score und den Gründen, die ausgelöst haben. Bei regelbasierten Prüfungen kommt die Antwort in deutlich unter einer Sekunde.
Was die API kann
Spam- & Nutzerprüfungen
Schicken Sie beliebigen Text durch dieselbe Engine, die Telm-Gruppen schützt — Einzelaufrufe, Batches bis zu 20 und Nutzerprüfung gegen CAS plus Telms eigenen Datensatz.
POST /spam/checkPOST /spam/check-batchPOST /users/checkGruppen & Einstellungen
Lesen und patchen Sie Schutzeinstellungen, verwalten Sie eigene Moderationsregeln und die Whitelist — für eine Gruppe oder eine ganze Flotte.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistJournal & Analytics
Lesen Sie jede Engine-Entscheidung mit Urteil, Score und ausgelösten Regeln, rufen Sie tägliche Analytics-Reihen ab und behalten Sie Ihren Kontingentverbrauch im Blick.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageWebhook-Verwaltung
Erstellen und verwalten Sie Webhook-Endpunkte, senden Sie Test-Pings und prüfen Sie den Zustellverlauf — vollständig über die API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesEhrliche Limits, klar deklariert
| Tarif | Aufrufe pro Tag | Ratenlimit | API-Zugriff |
|---|---|---|---|
| Free | 100 | 60/min | Spam-Prüfung |
| Basic | 1 000 | 60/min | Spam-Prüfung |
| Pro | 10 000 | 600/min | Vollständige API + Webhooks |
| Business | 50 000 | 1 800/min | Vollständige API + Webhooks |
Limits gelten pro Konto, nicht pro Schlüssel. Jede Antwort trägt die Header X-Quota-Limit, X-Quota-Used und X-Quota-Reset, und beim Erreichen eines Limits kommt ein sauberer 429 mit Retry-After zurück — keine Überraschungen.
Schlüssel, wie sie sein sollten
Einmal angezeigt, gehasht gespeichert
Der vollständige Schlüssel erscheint genau einmal, bei der Erstellung. Telm speichert nur einen Hash — niemand, auch wir nicht, kann Ihren Schlüssel zurücklesen.
Lese-/Schreibrechte
Schlüssel tragen Lese- und Schreibrechte. Geben Sie Ihrem Reporting-Skript einen Nur-Lese-Schlüssel — er kann physisch keine Einstellung ändern.
Sofortiger Widerruf
Widerrufen Sie einen beliebigen Schlüssel im Dashboard, und er funktioniert sofort nicht mehr. Ein Kill-Switch pro Konto kann den gesamten API-Zugriff auf einen Schlag einfrieren.
Die vollständige API und Webhooks sind in Pro und Business enthalten. Die Spam-Prüfung ist in jedem Tarif verfügbar — auch in Free — innerhalb des Tageskontingents.
Dieselbe Engine, jetzt unter Ihrer Kontrolle
Die öffentliche API stellt dieselbe Moderations-Engine bereit, die den Bot von Telm antreibt — keine vereinfachte Nachbildung. Schicken Sie per POST einen Text an /spam/check, und er durchläuft exakt dieselbe Pipeline wie in Ihren Gruppen: Reputationssignale, Regeln und optional den KI-Klassifikator. So können Sie Telms Urteil überall einbetten: in ein Support-Formular, Ihren eigenen Bot, einen Kommentarbereich, ein internes Tool.
Über Prüfungen hinaus verwaltet die API Ihre Gruppen als Code. Schutzeinstellungen lesen und patchen, Moderationsregeln anlegen, Whitelists pflegen — dieselben Operationen wie im Dashboard, nur skriptbar. Agenturen mit Dutzenden Communities rollen eine Richtlinienänderung mit einer einzigen Schleife aus statt mit Dutzenden Klicks.
Die Historie ist erstklassig: Der Journal-Endpunkt liefert jede Entscheidung der Engine — Urteil, Score, welche Regeln ausgelöst haben, welche Aktion folgte — mit Cursor-Paginierung, die fürs Archivieren gemacht ist. Zusammen mit dem Analytics-Endpunkt bauen Sie Compliance-Archive, interne Dashboards oder Alerting auf den echten Daten Ihrer Gruppe auf.
Die Authentifizierung ist bewusst langweilig: Bearer-Schlüssel, die Sie im Dashboard erstellen, einmalig angezeigt, gehasht gespeichert, mit Lese-/Schreibrechten und sofortigem Widerruf. Jede Antwort trägt Kontingent-Header, damit Ihre Integration jederzeit weiß, woran sie ist.
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.
Verwandte Funktionen
Entdecken Sie weitere Möglichkeiten, wie Telm Ihrer Community helfen kann