المؤسسة
تملك المؤسسة كل هاتف ورسالة وجهة اتصال ومفتاح. يمكن لمفاتيح API قراءة ملف المؤسسة، أما إعادة تسميتها وإدارة الفريق فتحتاج مستخدما مسجل الدخول، غالبا من البوابة (الفريق، الإعدادات).
قراءة المؤسسة
Section titled “قراءة المؤسسة”/v1/orgيستطيع أي مفتاح API أو مستخدم في المؤسسة استدعاءها دون صلاحية محددة.
curl https://api.smsfabric.com/v1/org \ -H "X-Api-Key: $SMSFABRIC_API_KEY"{ "id": "org_n5q8t1w4z7c0f3i6l9o2r5u8", "name": "Acme Retail", "slug": "acme-retail", "status": "active", "plan": "free", "createdAt": "2026-09-01T08:00:00.000Z"}قيمة status هي active أو suspended.
إعادة تسمية المؤسسة
Section titled “إعادة تسمية المؤسسة”/v1/orgsettings:manageللمستخدمين فقط| حقل المحتوى | النوع | إلزامي | القيود |
|---|---|---|---|
name |
string | لا | من 1 إلى 120 حرفا. |
curl -X PATCH https://api.smsfabric.com/v1/org \ -H "Authorization: Bearer $SMSFABRIC_USER_TOKEN" \ -H "Content-Type: application/json" \ -d '{"name": "Acme Retail Egypt"}'يعيد المؤسسة. يُسجل في التدقيق باسم org.updated.
عرض الأعضاء
Section titled “عرض الأعضاء”/v1/org/membersللمستخدمين فقطكل الأعضاء في صفحة واحدة.
curl https://api.smsfabric.com/v1/org/members \ -H "Authorization: Bearer $SMSFABRIC_USER_TOKEN"{ "data": [ { "userId": "usr_o9r2u5x8a1d4g7j0m3p6s9v2", "name": "Mona Hassan", "email": "mona@acme.example", "role": "owner", "joinedAt": "2026-09-01T08:00:00.000Z" }, { "userId": "usr_p0s3v6y9b2e5h8k1n4q7t0w3", "name": "Omar Saleh", "email": "omar@acme.example", "role": "developer", "joinedAt": "2026-10-11T12:30:00.000Z" } ], "nextCursor": null}تغيير دور عضو
Section titled “تغيير دور عضو”/v1/org/members/:userIdmembers:manageللمستخدمين فقط| حقل المحتوى | النوع | إلزامي | القيود |
|---|---|---|---|
role |
string | نعم | owner أو admin أو developer أو campaign_manager أو agent أو viewer أو billing. |
curl -X PATCH https://api.smsfabric.com/v1/org/members/usr_p0s3v6y9b2e5h8k1n4q7t0w3 \ -H "Authorization: Bearer $SMSFABRIC_USER_TOKEN" \ -H "Content-Type: application/json" \ -d '{"role": "admin"}'يعيد العضو ويُسجل في التدقيق. يعيد 409 last_owner إذا كان التغيير سيترك المؤسسة دون مالك.
إزالة عضو
Section titled “إزالة عضو”/v1/org/members/:userIdmembers:manageللمستخدمين فقطيعيد 204 ويُسجل في التدقيق. يعيد 409 last_owner للمالك الوحيد.
curl -X DELETE https://api.smsfabric.com/v1/org/members/usr_p0s3v6y9b2e5h8k1n4q7t0w3 \ -H "Authorization: Bearer $SMSFABRIC_USER_TOKEN"دعوة عضو
Section titled “دعوة عضو”/v1/org/invitationsmembers:manageللمستخدمين فقطيرسل رابط دعوة بالبريد. يعيد 201. يدعم Idempotency-Key. يُسجل في التدقيق باسم member.invited.
| حقل المحتوى | النوع | إلزامي | القيود |
|---|---|---|---|
email |
string | نعم | بريد صالح. |
role |
string | نعم | أحد الأدوار أعلاه. |
curl https://api.smsfabric.com/v1/org/invitations \ -H "Authorization: Bearer $SMSFABRIC_USER_TOKEN" \ -H "Content-Type: application/json" \ -d '{"email": "sara@acme.example", "role": "campaign_manager"}'{ "id": "inv_q1t4w7z0c3f6i9l2o5r8u1x4", "email": "sara@acme.example", "role": "campaign_manager", "expiresAt": "2026-11-26T13:30:00.000Z", "acceptedAt": null, "createdAt": "2026-11-19T13:30:00.000Z"}يعيد 409 already_member إذا كان الشخص في المؤسسة أصلا.
عرض الدعوات
Section titled “عرض الدعوات”/v1/org/invitationsmembers:manageللمستخدمين فقطكل الدعوات في صفحة واحدة.
curl https://api.smsfabric.com/v1/org/invitations \ -H "Authorization: Bearer $SMSFABRIC_USER_TOKEN"إلغاء دعوة
Section titled “إلغاء دعوة”/v1/org/invitations/:idmembers:manageللمستخدمين فقطيتوقف الرابط عن العمل. يعيد 204. يُسجل في التدقيق باسم member.invitation_revoked.
curl -X DELETE https://api.smsfabric.com/v1/org/invitations/inv_q1t4w7z0c3f6i9l2o5r8u1x4 \ -H "Authorization: Bearer $SMSFABRIC_USER_TOKEN"