قوّة الإشراف،
قابلة للاستدعاء من شيفرتك
اربط Telm بأنظمتك الخاصة: افحص أي نص بمحرّك مكافحة الرسائل المزعجة الإنتاجي، وأدِر إعدادات المجموعات وقواعدها من الشيفرة، واقرأ سجلّ القرارات والتحليلات — كل ذلك عبر REST API نظيف بمفاتيح تتحكّم بها.
- REST v1 مستقر
- فحص الرسائل المزعجة في كل خطة
- Webhooks مضمّنة
أول استدعاء لك في 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) تُنشأ في لوحة تحكّمك، وتُعرض مرّة واحدة، وتُخزَّن مُجزّأة (hashed)، بنطاقات قراءة/كتابة وإلغاء فوري. ويحمل كل ردّ ترويسات الحصّة كي تعرف تكاملاتك دائماً أين تقف.
الأسئلة الشائعة
أي الخطط تشمل الوصول إلى 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؟
من لوحة التحكّم ضمن الإعدادات ← API & Webhooks. يُعرض المفتاح مرّة واحدة عند إنشائه — ولا يُخزَّن سوى تجزئته. يمكنك الاحتفاظ بما يصل إلى 10 مفاتيح نشطة، وتقييد نطاقها إلى القراءة فقط، وإلغاء أيّ منها فوراً.
هل يمكن استخدام مُصنِّف الذكاء الاصطناعي عبر API؟
نعم — مرّر include_ai في /spam/check فيضيف الردّ حُكم الذكاء الاصطناعي. تُسحب فحوصات الذكاء الاصطناعي من حصّة ذكاء اصطناعي يومية منفصلة متاحة على Pro وBusiness.
هل توجد مواصفة OpenAPI؟
نعم، مواصفة OpenAPI 3.1 الكاملة القابلة للقراءة آلياً منشورة إلى جانب وثائق المطوّرين، فيمكنك توليد عملاء (clients) أو ربطها بأدواتك.
أين تستخدم الفرق هذا
أنواع مجتمعات حقيقية تؤدّي فيها هذه الميزة العبء الأكبر.
إدارة احترافية لمجموعات الشركات ومجتمعات العملاء. حماية قوية مع سجلات تدقيق مفصّلة.
احفظ قنوات الدعم خالية من الرسائل المزعجة مع السماح للمستخدمين الجدد بطرح الأسئلة. يجعل وضع الدعم عملية الانضمام سهلة.
احمِ مجموعة العملات المشفّرة من المحتالين والإسقاطات الجوّية المزيّفة وروابط التصيّد — بما في ذلك عمليات الاحتيال المخفيّة داخل الصور.
ميزات ذات صلة
اكتشف المزيد من الطرق التي يمكن لـ Telm مساعدة مجتمعك بها