المصادقة

أنشئ المفاتيح من صفحة مفاتيح API. تبدأ المفاتيح بـ mc_ وتُعرض مرة واحدة. يحتفظ سطر ببصمتها وأحرفها الأولى ووقت آخر استخدام فقط. تقبل REST API وخادم MCP الترويسة نفسها. يمكن للحساب امتلاك 20 مفاتيح نشطة كحد أقصى.

Authorization: Bearer mc_…

إذا استدعى مفتاح الاشتراكات فقط إجراءً آخر، فالرد 403 forbidden. المفاتيح التي أُنشئت قبل إضافة المستويات مخصّصة للاشتراكات فقط. المفاتيح الملغاة تتلقى 401 unauthorized.

استخدم مفتاح الاشتراكات فقط من المتصفح. وعند الإرسال من خادم، مرّر عنوان IP للزائر لتطبيق حد الاشتراكات لكل زائر.

await fetch("https://app.satrmail.com/api/v1/contacts", {
  method: "POST",
  headers: {
    Authorization: "Bearer mc_your_signups_only_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ email: form.email.value, source: "website" }),
});

لكل مفتاح 300 طلبًا كل 1 دقيقة عبر REST وMCP معًا. لبعض الإجراءات حد خاص بكل مفتاح وبالحساب. تتشارك المفاتيح والتطبيقات المتصلة ولوحة التحكم حد الحساب، لذا لا يزيده إنشاء مفاتيح إضافية. عند تجاوز الحد، يكون الرد 429 rate_limited؛ انتظر ثم أعد المحاولة.

تتطلب جميع نقاط النهاية، باستثناء الفوترة، خطة نشطة؛ وإلا فالرد 402 subscription_required. تستمر الاشتراكات ورسائل التأكيد عند تجاوز حدود الخطة، لكن إرسال الحملات يتوقف مع plan_limit_emails أو plan_limit_subscribers. تُحسب رسائل الترحيب ضمن رسائل الشهر مثل أعداد النشرة. عند نفادها، لا يتلقى المشتركون الجدد رسالة ترحيب حتى يبدأ العد من جديد أو تتوسع الخطة، ولا تُرسل إليهم بأثر رجعي. يوضّح الحقل usage.welcomeEmailsPaused في get_billing وget_overview هذه الحالة.

تستخدم نقاط نهاية الفوترة StreamPay والريال السعودي. يبقى الاشتراك غير متاح حتى اعتماد إعدادات المزوّد والأسعار الشهرية والسنوية المهيأة كلٌّ على حدة. ما زالت معالجة دورة الاشتراك التشغيلية والتحقق الفعلي قيد العمل. أسعار MailCheap القديمة وحساب السنة بسعر عشرة أشهر ليست عروضًا معتمدة لسطر.