הקריאה הראשונה שלכם ב-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) שנוצרים בלוח הבקרה שלכם, מוצגים פעם אחת, נשמרים מגובבים, עם הרשאות קריאה/כתיבה וביטול מיידי. כל תגובה נושאת כותרות מכסה כך שהאינטגרציה שלכם תמיד יודעת היכן היא עומדת.
שאלות נפוצות
אילו תוכניות כוללות גישה ל-API?
בדיקת ספאם (/spam/check) עובדת בכל תוכנית, כולל Free, בגבולות המכסה היומית. ה-API המלא — הגדרות קבוצה, כללים, יומן, אנליטיקה, סינון משתמשים ו-Webhooks — כלול בתוכניות Pro ו-Business.
מהן מגבלות הבקשות?
מכסות יומיות לפי תוכנית: Free 100, Basic 1,000, Pro 10,000, Business 50,000 קריאות. מגבלות קצב: 60 בקשות לדקה ב-Free וב-Basic, 600 ב-Pro, 1,800 ב-Business. כל תגובה כוללת את הכותרות X-Quota-Limit, X-Quota-Used ו-X-Quota-Reset.
כיצד אני משיג מפתח API?
בלוח הבקרה תחת Settings → API & Webhooks. המפתח מוצג פעם אחת בעת היצירה — נשמר רק הגיבוב שלו. אפשר להחזיק עד 10 מפתחות פעילים, להגביל אותם לקריאה בלבד, ולבטל כל אחד מהם באופן מיידי.
האם ניתן להשתמש במסווג הבינה המלאכותית דרך ה-API?
כן — העבירו include_ai בקריאת /spam/check והתגובה תוסיף את פסק הבינה המלאכותית. בדיקות בינה מלאכותית נשאבות ממכסת בינה מלאכותית יומית נפרדת הזמינה ב-Pro וב-Business.
האם קיים מפרט OpenAPI?
כן, מפרט OpenAPI 3.1 המלא והקריא-למכונה מתפרסם לצד תיעוד המפתחים, כך שתוכלו לייצר לקוחות או לחבר אותו לכלים שלכם.
היכן צוותים משתמשים בזה
סוגי קהילות אמיתיים שבהם התכונה הזו עושה את העבודה הכבדה.
ניהול מקצועי לקבוצות חברות וקהילות לקוחות. הגנה חזקה עם יומני ביקורת מפורטים.
שמור על ערוצי התמיכה נקיים מספאם תוך מתן אפשרות למשתמשים חדשים לשאול שאלות. מצב התמיכה מקל על תהליך ההצטרפות.
הגנו על קבוצת הקריפטו שלכם מפני נוכלים, איירדרופים מזויפים וקישורי פישינג — כולל הונאות המוסתרות בתוך תמונות.
תכונות קשורות
גלה עוד דרכים שבהן Telm יכול לעזור לקהילה שלך