تخطَّ إلى المحتوى

الباقات

تحدد الباقة ما يحق للمؤسسة استخدامه: الهواتف والمقاعد ومفاتيح API ونقاط نهاية webhook والرسائل في اليوم وفي الشهر، وميزات مثل مجموعات الأجهزة والإرسال المجدول. تعرض البوابة باقتك واستخدامك تحت الإعدادات (الباقة والاستخدام)، وإلى أن تُفعل الفوترة يجري فريق SMSFabric تغييرات الباقة. أين يُطبق كل حد، والخطأ الذي يعيده، تجده في الحدود.

الحقل النوع الوصف
key string معرف ثابت، مثل free أو starter أو pro أو business أو enterprise.
name string الاسم المعروض، مثل Starter.
priceMonthlyCents integer أو null السعر الشهري بسنتات الدولار الأمريكي. null يعني أن السعر حسب العقد.
priceAnnualCents integer أو null السعر السنوي بسنتات الدولار الأمريكي. null يعني أنه غير معروض، أو حسب العقد.
priceIsStartingAt boolean true حين يكون السعر الشهري سعرا يبدأ منه.
limits object الحدود الرقمية أدناه.
addOns object الهواتف والمقاعد الإضافية التي يمكن شراؤها في هذه الباقة.
features string[] الميزات التي تشملها الباقة.
footerRequired boolean تنتهي كل رسالة صادرة بسطر Sent with SMSFabric.
support string community أو email_2d أو email_1d أو priority_4h أو named_contact.
isPublic boolean تظهر في قائمة الأسعار.
sortOrder integer ترتيب العرض، الأصغر أولا.

يحمل limits الحقول phones وsimsPerPhone وseats وmessagesPerMonth وmessagesPerDay وapiKeys وwebhooks وcontacts وcampaignRecipients (كل منها رقم، أو null حين لا يوجد حد ثابت)، والحقول apiKeyRequestsPerMinute وrecipientsPerRequest وretentionDays وauditLogDays (رقم دائما).

يحمل addOns الحقلين extraPhonePriceCents وextraSeatPriceCents (null حين لا تُباع الإضافة في هذه الباقة)، وextraPhoneMessages (الرسائل الشهرية التي يضيفها كل هاتف إضافي)، وmaxPhones (أقصى عدد من الهواتف تبلغه الباقة مع الإضافات، وnull بلا سقف).

تضم features أيا مما يلي: scheduled_sends وcsv_export وtemplates وpools وcampaigns وshared_inbox وanalytics وverify_api وconfigurable_retention وcloud_routing وcustom_roles وsso وsiem_streaming وsla وdata_residency.

GET/v1/plans

قائمة الأسعار العامة: كل باقة عامة، بترتيب العرض، في صفحة واحدة. لا تحتاج مفتاحا، وتجيب أثناء الصيانة أيضا.

نافذة طرفيّة
curl https://api.smsfabric.com/v1/plans
{
"data": [
{
"key": "starter",
"name": "Starter",
"priceMonthlyCents": 900,
"priceAnnualCents": 9000,
"priceIsStartingAt": false,
"limits": {
"phones": 1,
"simsPerPhone": null,
"seats": 2,
"messagesPerMonth": 5000,
"messagesPerDay": 500,
"apiKeys": 2,
"webhooks": 2,
"apiKeyRequestsPerMinute": 300,
"recipientsPerRequest": 100,
"retentionDays": 30,
"auditLogDays": 30,
"contacts": 1000,
"campaignRecipients": 0
},
"addOns": { "extraPhonePriceCents": null, "extraPhoneMessages": 0, "maxPhones": null, "extraSeatPriceCents": null },
"features": ["scheduled_sends", "csv_export", "templates"],
"footerRequired": false,
"support": "email_2d",
"isPublic": true,
"sortOrder": 20
}
],
"nextCursor": null
}

يظهر هنا باقة واحدة، ويحمل data كل الباقات العامة. تتغير الأسعار والحدود مع الوقت، فاقرأها من نقطة النهاية هذه بدل نسخها في الكود.

GET/v1/org/plan

باقة مؤسستك، والحدود التي تنطبق عليها، وما استخدمته منها. يستطيع أي مفتاح API أو مستخدم مسجل الدخول في المؤسسة استدعاءها، ولا تحتاج صلاحية.

نافذة طرفيّة
curl https://api.smsfabric.com/v1/org/plan \
-H "X-Api-Key: $SMSFABRIC_API_KEY"
{
"plan": { "key": "pro", "name": "Pro" },
"limits": {
"phones": 7,
"simsPerPhone": null,
"seats": 5,
"messagesPerMonth": 35000,
"messagesPerDay": 3500,
"apiKeys": 10,
"webhooks": 10,
"apiKeyRequestsPerMinute": 1200,
"recipientsPerRequest": 100,
"retentionDays": 90,
"auditLogDays": 365,
"contacts": 10000,
"campaignRecipients": 5000
},
"features": ["scheduled_sends", "csv_export", "templates", "pools", "campaigns", "shared_inbox", "analytics"],
"footerRequired": false,
"extraPhones": 2,
"extraSeats": 0,
"overridden": [],
"usage": {
"phones": 6,
"seats": 4,
"apiKeys": 3,
"webhooks": 1,
"messagesToday": 812,
"messagesThisMonth": 20417
},
"dayResetsAt": "2026-11-20T00:00:00.000Z",
"monthResetsAt": "2026-12-01T00:00:00.000Z"
}
الحقل الوصف
plan key الباقة وname.
limits حدود الباقة بعد إضافاتك: كل هاتف إضافي يضيف هاتفا واحدا ويضيف extraPhoneMessages إلى الحصة الشهرية، وتزيد الحصة اليومية بالنسبة نفسها. والحد الذي يضبطه SMSFabric لمؤسستك يحل محل حد الباقة.
features الميزات المتاحة لك.
footerRequired true حين يُضاف سطر Sent with SMSFabric إلى رسائلك.
extraPhones وextraSeats الإضافات على مؤسستك.
overridden أسماء الحدود التي ضبطها SMSFabric لمؤسستك بدل حدود الباقة.
usage ما يُحتسب على الحدود الآن. seats هو الأعضاء والدعوات المفتوحة. يعد messagesToday وmessagesThisMonth الرسائل الصادرة، واحدة لكل مستلم، ولا تُحتسب رسائل البيئة التجريبية ولا المستلمون في القائمة السوداء ولا الرسائل الواردة.
dayResetsAt وmonthResetsAt متى تبدأ الحصة اليومية (00:00 بتوقيت UTC) والحصة الشهرية (يوم 1، الساعة 00:00 بتوقيت UTC) من جديد.

حين يعيد الإرسال 429 quota_exceeded، يخبرك هذان الوقتان متى يعود الإرسال. انظر الأخطاء.