قوّة الإشراف،
قابلة للاستدعاء من شيفرتك
اربط 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 | فحص الرسائل المزعجة |
| 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، وPro 10,000، وBusiness 50,000 استدعاء. حدود المعدّل: 60 طلبًا في الدقيقة على Free، و600 على Pro، و1,800 على Business. وتتضمّن كل استجابة الترويسات X-Quota-Limit وX-Quota-Used وX-Quota-Reset.
كيف أحصل على مفتاح API؟
من لوحة التحكم ضمن الإعدادات ← API & Webhooks. يظهر المفتاح مرة واحدة عند إنشائه — ولا نخزّن سوى بصمته (hash). يمكنك الاحتفاظ بما يصل إلى 10 مفاتيح نشطة، وتقييدها بصلاحية القراءة فقط، وإلغاء أي منها فورًا.
هل يمكن استخدام مصنِّف الذكاء الاصطناعي عبر API؟
نعم، في Pro وBusiness: أضِف include_ai إلى طلب /spam/check، ويُحتسب كل فحص بالذكاء الاصطناعي من حصة API يومية منفصلة — 1,000 في Pro، و10,000 في Business. في Free، تعتمد فحوصات الرسائل المزعجة عبر API على القواعد فقط. تخص هذه الحصة استدعاءات API وحدها: أما الإشراف بالذكاء الاصطناعي داخل مجموعاتك على Telegram فمشمول في كل الخطط.
هل تتوفر مواصفة OpenAPI؟
نعم، تُنشر مواصفة OpenAPI 3.1 الكاملة القابلة للقراءة آليًا إلى جانب وثائق المطوّرين، فيمكنك توليد عملاء منها أو ربطها بأدواتك.
ميزات ذات صلة
اكتشف المزيد من الطرق التي يمكن لـ Telm مساعدة مجتمعك بها