مجموعات الأجهزة
المجموعة اسم لعدة هواتف. الرسالة المرسلة مع poolId تذهب إلى هواتف المجموعة المتصلة بالتناوب. إذا لم يقبلها الهاتف خلال 10 ثوان، أو رفضها، أو انقطع اتصاله، تنتقل إلى هاتف آخر في المجموعة. أضف هاتفا إلى مجموعة عبر PATCH /v1/devices/:id مع { "poolId": "pool_…" }. انظر المجموعات في البوابة.
كائن المجموعة
Section titled “كائن المجموعة”| الحقل | النوع | الوصف |
|---|---|---|
id |
string | pool_… |
name |
string | فريد داخل مؤسستك. |
deviceIds |
string[] | الهواتف في المجموعة. |
createdAt |
string |
عرض المجموعات
Section titled “عرض المجموعات”GET
/v1/poolsdevices:readيعيد كل المجموعات في صفحة واحدة (nextCursor: null).
curl https://api.smsfabric.com/v1/pools \ -H "X-Api-Key: $SMSFABRIC_API_KEY"{ "data": [ { "id": "pool_c6f9j2m5p8s1v4y7b0e3h6k9", "name": "Cairo office", "deviceIds": ["dev_m4p7s2v5y8b1e4h7k0n3q6t9", "dev_n5q8t1w4z7c0f3i6l9o2r5u8"], "createdAt": "2026-10-05T09:00:00.000Z" } ], "nextCursor": null}إنشاء مجموعة
Section titled “إنشاء مجموعة”POST
/v1/poolsdevices:manageينشئ مجموعة فارغة ويعيد 201. يدعم Idempotency-Key. يُسجل في التدقيق باسم pool.created.
| حقل المحتوى | النوع | إلزامي | القيود |
|---|---|---|---|
name |
string | نعم | من 1 إلى 120 حرفا، فريد داخل مؤسستك. |
curl https://api.smsfabric.com/v1/pools \ -H "X-Api-Key: $SMSFABRIC_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name": "Cairo office"}'{ "id": "pool_c6f9j2m5p8s1v4y7b0e3h6k9", "name": "Cairo office", "deviceIds": [], "createdAt": "2026-11-19T10:30:00.000Z" }| الخطأ | متى |
|---|---|
409 pool_exists |
توجد مجموعة بهذا الاسم. |
إعادة تسمية مجموعة
Section titled “إعادة تسمية مجموعة”PATCH
/v1/pools/:iddevices:manage| حقل المحتوى | النوع | إلزامي | القيود |
|---|---|---|---|
name |
string | نعم | من 1 إلى 120 حرفا. |
curl -X PATCH https://api.smsfabric.com/v1/pools/pool_c6f9j2m5p8s1v4y7b0e3h6k9 \ -H "X-Api-Key: $SMSFABRIC_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name": "Cairo HQ"}'يعيد المجموعة، أو 404 not_found إذا لم تكن في مؤسستك.
حذف مجموعة
Section titled “حذف مجموعة”DELETE
/v1/pools/:iddevices:manageيحذف المجموعة. تبقى هواتفها مقترنة وتخرج منها (poolId: null). يعيد 204. يُسجل في التدقيق باسم pool.deleted.
curl -X DELETE https://api.smsfabric.com/v1/pools/pool_c6f9j2m5p8s1v4y7b0e3h6k9 \ -H "X-Api-Key: $SMSFABRIC_API_KEY"