سطر
ابدأ نشرتك

واجهة API وخادم MCP

كل ما تفعله لوحة التحكم، من برنامجك أو مساعدك الذكي

تنفّذ REST API وخادم MCP الإجراءات نفسها التي تنفّذها لوحة التحكم، وعددها 91، وبالفحوص نفسها: حدود الخطط وقواعد المرسل وفحوص ما قبل الإرسال وإيقاف الحملات بسبب الارتدادات أو الشكاوى أو معدل البريد المزعج في Gmail، وحظر الحسابات والإرسال الأول على مراحل.
واجهة REST APIطلبات وردود بصيغة JSONhttps://app.satrmail.com/api/v1
خادم MCPStreamable HTTPhttps://app.satrmail.com/mcp
  1. 1

    أنشئ مفتاح API

    من صفحة مفاتيح API، اختر الوصول الكامل للبرامج والمساعدين الذكيين، أو الاشتراكات فقط لنماذج الاشتراك في شيفرة موقعك. يُعرض المفتاح مرة واحدة.

  2. 2

    أرسل طلبًا

    أرسل المفتاح مع كل طلب بوصفه رمز Bearer. يعرض هذا الطلب نشراتك وإعداداتها.

    الطرفية
    curl https://app.satrmail.com/api/v1/newsletters \
  -H "Authorization: Bearer $MAILCHEAP_API_KEY"
  3. 3

    أو اربط مساعدًا ذكيًا

    يكفي أمر واحد لـ Claude Code، وبضعة أسطر لـ Codex وCursor. ويتصل ChatGPT وClaude وGrok Bot بتسجيل الدخول. تجد الخطوات في صفحة MCP.

    الطرفية
    claude mcp add --transport http --scope user mailcheap https://app.satrmail.com/mcp \
  --header "Authorization: Bearer $MAILCHEAP_API_KEY"

ما يمكنك فعله

نظرة عامة2المشتركون ونتائج البريد والإرسال بالساعة، كما في الصفحة الأولى من لوحة التحكم.النشرات11المرسل والعنوان البريدي ورسائل الترحيب والتأكيد وتنظيف القائمة والموقع ونطاقه ومظهره.الفريق4الأشخاص الذين يعملون مع مالك النشرة، بصلاحية مشرف أو عضو، ودعواتهم.الإشعارات5ما يعرضه جرس لوحة التحكم، مثل حملة متوقفة أو استيراد مكتمل، ورسائل سطر إلى المالك.الحملات21المسودات والمعاينة بصفتك جهة اتصال ورسائل الاختبار والجدولة والإرسال المرحلي والتقارير.الكتّاب4كتّاب أعداد النشرة: الاسم والصورة اللذان يراهما القراء والعنوان الذي تصله الردود.جهات الاتصال23البحث والاشتراكات والاستيراد مع الفحوص وتغيير الحالة والحذف والتصدير.الشرائح6شروط محفوظة تختار بعض جهات اتصال النشرة حسب التفاعل أو تاريخ الاشتراك أو المصدر أو العنوان لإرسال الحملات إليهم فقط.النطاقات4نطاقات الإرسال الخاصة وسجلات DNS والعنوان المشترك.الصور2صور محتوى الحملات على شبكة توزيع سطر، محفوظة في مكتبة الحساب لإعادة استخدامها.مفاتيح API5مفاتيح واجهة REST API وخادم MCP والتطبيقات المتصلة عبر OAuth.الفوترة4الخطة والاستخدام وروابط StreamPay بالريال السعودي؛ تفعيل الاشتراك مشروط باعتماد الأسعار وإعدادات المزوّد.

للمساعدين الآليين الذين يقرؤون هذه الوثائق

  • /llms.txt يسرد هذه الصفحات وجميع نقاط النهاية.
  • /llms-full.txt يحتوي المرجع كاملًا بصيغة Markdown.
  • /api/v1/openapi.json يصف الواجهة بصيغة OpenAPI 3.1، ويُولّد من المخططات نفسها التي تستخدمها أدوات MCP.

لغة الوثائق والعقود البرمجية

تتبع هذه الأدلة وشروح نقاط النهاية اللغة التي اخترتها. تبقى الأوامر والروابط وأسماء الحقول والقيم المحدّدة ومعرّفات الإجراءات وأمثلة البيانات كما هي. وتبقى /llms.txt و/llms-full.txt وOpenAPI مراجع إنجليزية معيارية تُولّد من السجل نفسه. يحتفظ اسم الإعداد mailcheap وبادئة المفاتيح mc_ والمتغير MAILCHEAP_API_KEY بالتوافق مع عملاء المشروع الأصلي.