הקריאה הראשונה שלכם ב-30 שניות
בלי טקסי SDK: קריאת HTTPS עם המפתח שלכם היא כל מה שנדרש.
$ 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"]
}בקשה אחת, פסק אחד מהמנוע הייצורי — עם ציון והסיבות שהופעלו. התגובה מגיעה הרבה מתחת לשנייה עבור בדיקות מבוססות-כללים.
מה ה-API יכול לעשות
בדיקות ספאם ומשתמשים
העבירו כל טקסט דרך אותו מנוע שמגן על קבוצות Telm — קריאות בודדות, אצוות של עד 20, וסינון משתמשים מול CAS בתוספת מסד הנתונים של Telm עצמה.
POST /spam/checkPOST /spam/check-batchPOST /users/checkקבוצות והגדרות
קראו ועדכנו הגדרות הגנה, נהלו כללי מודרציה מותאמים ואת הרשימה הלבנה — לקבוצה אחת או לצי שלם מהן.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistיומן ואנליטיקה
קראו כל החלטה של המנוע יחד עם הפסק, הציון והכללים שהופעלו, משכו סדרות אנליטיקה יומיות, ועקבו אחר ניצול המכסה שלכם.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageניהול Webhooks
צרו ונהלו נקודות קצה של Webhooks, שלחו פינגי בדיקה ובחנו את היסטוריית המשלוח — הכול דרך ה-API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesמגבלות כנות, מודפסות על הקופסה
| תוכנית | קריאות ליום | מגבלת קצב | גישה ל-API |
|---|---|---|---|
| Free | 100 | 60/min | בדיקת ספאם |
| Basic | 1 000 | 60/min | בדיקת ספאם |
| Pro | 10 000 | 600/min | API מלא + Webhooks |
| Business | 50 000 | 1 800/min | API מלא + Webhooks |
המגבלות חלות לכל חשבון, לא לכל מפתח. כל תגובה נושאת את הכותרות X-Quota-Limit, X-Quota-Used ו-X-Quota-Reset, וחריגה ממגבלה מחזירה 429 נקי עם Retry-After — בלי הפתעות.
מפתחות בנויים כמו שצריך
מוצג פעם אחת, נשמר מגובב
המפתח המלא מופיע בדיוק פעם אחת, בעת היצירה. Telm שומרת רק גיבוב — איש, כולל אנחנו, אינו יכול לקרוא את המפתח שלכם בחזרה.
הרשאות קריאה/כתיבה
המפתחות נושאים הרשאות קריאה וכתיבה. תנו לתסריט הדיווח שלכם מפתח לקריאה בלבד — הוא פיזית אינו יכול לשנות שום הגדרה.
ביטול מיידי
בטלו כל מפתח מלוח הבקרה והוא מפסיק לעבוד מיד. מתג-הרג ברמת החשבון יכול להקפיא את כל הגישה ל-API בבת אחת.
ה-API המלא ו-Webhooks כלולים ב-Pro וב-Business. בדיקת ספאם זמינה בכל תוכנית — כולל Free — בגבולות המכסה היומית.
אותו מנוע, כעת בשליטתכם
ה-API הציבורי חושף את אותו מנוע מודרציה שמריץ את הבוט של Telm — לא חיקוי מפושט. שלחו טקסט ב-POST אל /spam/check והוא עובר דרך אותו צינור בדיוק שהקבוצות שלכם משתמשות בו: אותות מוניטין, כללים, ואופציונלית מסווג הבינה המלאכותית. משמעות הדבר שאתם יכולים להטמיע את שיקול הדעת של Telm בכל מקום: טופס תמיכה, הבוט שלכם, אזור תגובות, כלי פנימי.
מעבר לבדיקות, ה-API מנהל את הקבוצות שלכם כקוד. קראו ועדכנו הגדרות הגנה, צרו כללי מודרציה, תחזקו רשימות לבנות — אותן פעולות כמו בלוח הבקרה, אך ניתנות לתסריט. סוכנויות שמנהלות עשרות קהילות יכולות להשיק שינוי מדיניות בלולאה אחת במקום עשרות לחיצות.
היסטוריה היא אזרחית מדרגה ראשונה: נקודת הקצה של היומן מחזירה כל החלטה שהמנוע קיבל — פסק, ציון, אילו כללים הופעלו, איזו פעולה ננקטה — עם דפדוף מבוסס סמן שנבנה לצורכי ארכוב. בשילוב עם נקודת הקצה של האנליטיקה תוכלו לבנות ארכיוני ציות, לוחות בקרה פנימיים או התראות מעל הנתונים האמיתיים של הקבוצה שלכם.
האימות משעמם במכוון: מפתחות נושא (bearer) שנוצרים בלוח הבקרה שלכם, מוצגים פעם אחת, נשמרים מגובבים, עם הרשאות קריאה/כתיבה וביטול מיידי. כל תגובה נושאת כותרות מכסה כך שהאינטגרציה שלכם תמיד יודעת היכן היא עומדת.
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.
תכונות קשורות
גלה עוד דרכים שבהן Telm יכול לעזור לקהילה שלך