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

مجموعات الأجهزة

المجموعة اسم لعدة هواتف. الرسالة المرسلة مع poolId تذهب إلى هواتف المجموعة المتصلة بالتناوب. إذا لم يقبلها الهاتف خلال 10 ثوان، أو رفضها، أو انقطع اتصاله، تنتقل إلى هاتف آخر في المجموعة. أضف هاتفا إلى مجموعة عبر PATCH /v1/devices/:id مع { "poolId": "pool_…" }. انظر المجموعات في البوابة.

الحقل النوع الوصف
id string pool_…
name string فريد داخل مؤسستك.
deviceIds string[] الهواتف في المجموعة.
createdAt string
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
}
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 توجد مجموعة بهذا الاسم.
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 إذا لم تكن في مؤسستك.

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"