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

المؤسسة

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

GET/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.

PATCH/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.

GET/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
}
PATCH/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 إذا كان التغيير سيترك المؤسسة دون مالك.

DELETE/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"
POST/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 إذا كان الشخص في المؤسسة أصلا.

GET/v1/org/invitationsmembers:manageللمستخدمين فقط

كل الدعوات في صفحة واحدة.

نافذة طرفيّة
curl https://api.smsfabric.com/v1/org/invitations \
-H "Authorization: Bearer $SMSFABRIC_USER_TOKEN"
DELETE/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"