المؤسسات
نقاط نهاية للقراءة فقط للمؤسسات التي تنتمي إليها. جميع المسارات على https://api.recordmeeting.com وتحتاج إلى مفتاح API. راجع المصادقة.
لعرض تسجيلات مؤسسة ما، استخدم عرض التسجيلات مع organization_id.
عرض المؤسسات
Section titled “عرض المؤسسات”GET /v1/organizationsيُرجع كل مؤسسة تنتمي إليها.
الاستجابة
Section titled “الاستجابة”{ "data": [ { "id": "org_uuid", "name": "Acme Inc.", "role": "ADMIN", "member_count": 12 } ]}قيم الأدوار
Section titled “قيم الأدوار”| الدور | الوصف |
|---|---|
OWNER | تحكم كامل في المؤسسة |
ADMIN | يدير الإعدادات والأعضاء والمجلدات |
EDITOR | ينشئ التسجيلات ويحررها ويعرضها |
VIEWER | صلاحية عرض فقط |
عرض المجلدات
Section titled “عرض المجلدات”GET /v1/organizations/:id/foldersيُرجع المجلدات النشطة في المؤسسة. يجب أن تكون عضوًا فيها.
الاستجابة
Section titled “الاستجابة”{ "data": [ { "id": "folder_uuid", "name": "Product team", "icon": null } ]}icon هو اسم أيقونة المجلد، أو null.
عرض الأعضاء
Section titled “عرض الأعضاء”GET /v1/organizations/:id/membersيُرجع أعضاء المؤسسة. يجب أن تكون عضوًا فيها.
الاستجابة
Section titled “الاستجابة”{ "data": [ { "id": "user_uuid", "email": "alice@example.com", "name": "Alice", "role": "EDITOR" } ], "emails_included": true}لا تُرجع عناوين البريد الإلكتروني إلا عندما يكون دورك في المؤسسة OWNER أو ADMIN. أما في الأدوار الأخرى فكل email يكون null وemails_included يكون false.
رموز الأخطاء
Section titled “رموز الأخطاء”| الرمز | حالة HTTP | المعنى |
|---|---|---|
FORBIDDEN | 403 | أنت لست عضوًا في هذه المؤسسة |