الباقات
تحدد الباقة ما يحق للمؤسسة استخدامه: الهواتف والمقاعد ومفاتيح API ونقاط نهاية webhook والرسائل في اليوم وفي الشهر، وميزات مثل مجموعات الأجهزة والإرسال المجدول. تعرض البوابة باقتك واستخدامك تحت الإعدادات (الباقة والاستخدام)، وإلى أن تُفعل الفوترة يجري فريق SMSFabric تغييرات الباقة. أين يُطبق كل حد، والخطأ الذي يعيده، تجده في الحدود.
كائن الباقة
Section titled “كائن الباقة”| الحقل | النوع | الوصف |
|---|---|---|
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.
عرض الباقات
Section titled “عرض الباقات”/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 كل الباقات العامة. تتغير الأسعار والحدود مع الوقت، فاقرأها من نقطة النهاية هذه بدل نسخها في الكود.
قراءة باقتك
Section titled “قراءة باقتك”/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، يخبرك هذان الوقتان متى يعود الإرسال. انظر الأخطاء.