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