التوثيق › لوحة التحكم › المؤسسات

المؤسسات

تجمع المؤسسة بيانات الاعتماد تحت مالك واحد ليتمكن عدة أشخاص من مشاركتها: مفاتيح API الخاصة بـ JSON API، ومستخدمو proxy لـ proxy port. يُحسب كل ما تستهلكه بيانات اعتماد المؤسسة ضمن خطة مالك المؤسسة، وليس ضمن حساب الشخص الذي أرسل request.

أين تجدها

سجل الدخول إلى dashboard وافتح المؤسسات في الشريط الجانبي. تظهر كل مؤسسة تنتمي إليها كصف:

العمود ما يعرضه
المؤسسة الاسم. انقر عليه، أو على فتح، للانتقال إلى صفحة المؤسسة الخاصة.
دورك مالك، أو مسؤول، أو عضو
الأعضاء عدد الأشخاص فيها، بما في ذلك المالك
المفاتيح عدد مفاتيح API التي تملكها المؤسسة
تاريخ الإنشاء وقت إنشائها
الإجراءات فتح

إنشاء مؤسسة

انقر على مؤسسة جديدة، وأدخل اسماً يتراوح بين 2 و60 حرفاً، ثم أكد. ستصبح أنت المالك. يجب أن يحتوي الاسم على حرف أو رقم واحد على الأقل، ولا يمكن أن يتطابق مع اسم مؤسسة موجودة (تتم مقارنة الحروف والأرقام مع تجاهل كل شيء آخر).

يتطلب إنشاء مؤسسة خطة تغطي أكثر من شخص واحد. يوضح صف المؤسسات التي تملكها في Usage & Limits ما إذا كانت خطتك تدعم ذلك.

الأدوار

توجد ثلاثة أدوار، ولكل مؤسسة مالك واحد فقط.

الدور الصلاحيات
عضو إنشاء واستخدام مفاتيح API ومستخدمي proxy التابعين للمؤسسة، وإعادة تسمية مفاتيح API الخاصة بها، والاطلاع على أعضاء المؤسسة وفرقها
مسؤول كل صلاحيات العضو، بالإضافة إلى إضافة الأشخاص وإزالتهم، وتغيير أدوارهم، وإدارة جميع بيانات اعتماد المؤسسة، وإعادة تسمية المؤسسة
مالك كل صلاحيات المسؤول، بالإضافة إلى نقل ملكية المؤسسة إلى شخص آخر. يتحمل المالك الخطة التي تتم فوترة جميع بيانات اعتماد المؤسسة عليها.

لا يمكن إزالة المالك أو مغادرته أو تخفيض رتبته. تنتقل الملكية في اتجاه واحد: عبر نقل الملكية.

الانتماء إلى المؤسسة هو ما يمنح حق الوصول إلى بيانات اعتمادها. يمكن لعضو ليس لديه صلاحيات مسؤول إنشاء مفتاح أو مستخدم proxy تدفع الشركة تكلفته، وهو الهدف الأساسي: لا ينبغي للمطور الذي يكتب أدوات التجميع أن يحتاج إلى بيانات اعتماد شخصية تتم فوترتها عليه سراً بدلاً من الشركة.

صفحة المؤسسة

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

  • الأعضاء: الأشخاص الموجودون في المؤسسة، بالإضافة إلى عناصر التحكم التي يمنحها لك دورك.
  • الفرق: الفرق التي تنتمي إليها داخل هذه المؤسسة، للقراءة فقط.

يحصل المالكون والمسؤولون أيضاً على زر إعادة التسمية في رأس الصفحة.

إضافة أشخاص

يحصل المالكون والمسؤولون على بطاقة إضافة عضو فوق جدول الأعضاء. أدخل عنوان بريد إلكتروني، واختر عضو أو مسؤول، ثم أرسل الطلب.

يعتمد ما يحدث بعد ذلك على العنوان، وتوضح لك لوحة التحكم الحالة المحددة:

  • العنوان يمتلك حساب FourA بالفعل: ينضم المستخدم فوراً ويتلقى بريداً إلكترونياً يحدد اسم المؤسسة، ومن قام بإضافته، وما تتيحه صلاحيات دوره.
  • العنوان لا يمتلك حساباً: ترسل FourA دعوة عبر البريد الإلكتروني وينضم المستخدم بمجرد تسجيل الدخول بهذا العنوان. لا يلزم النقر على أي شيء، وتعمل الدعوة سواء أنشأ حساباً جديداً أو كان لديه حساب سابق لم يفتحه من قبل.

تنتهي صلاحية الدعوات بعد 14 يوماً. وتؤدي إعادة إضافة العنوان نفسه إلى تجديد الدعوة المعلقة بدلاً من إنشاء دعوة مكررة.

يتلقى المالك بريداً إلكترونياً عند انضمام أي شخص، لأن العضو الجديد يستهلك من رصيد المالك. لا يتلقى أي مستخدم بريداً إلكترونياً لتأكيد إجرائه الخاص.

Pending Invitations

عند وجود دعوة واحدة مفتوحة على الأقل، يظهر جدول Invitations فوق Members، ويكون مرئياً للمالكين والمسؤولين. يعرض الجدول العنوان، والدور المحدد له، ومن أرسل الدعوة، وتاريخ إرسالها. تظل الدعوات منتهية الصلاحية معروضة مع وضع علامة توضح ذلك، لتتمكن من معرفة سبب عدم الانضمام. استخدم الإجراء الموجود في الصف لسحب أي دعوة.

Changing a Role

يقوم المالكون والمسؤولون بتغيير دور العضو بين Member و Admin عبر القائمة المنسدلة في عمود Role. توجد ثلاث قواعد:

  • لا يمكنك تغيير دورك بنفسك. اطلب ذلك من مسؤول آخر، أو غادر المؤسسة.
  • لا يمكن تعديل دور المالك من هنا. استخدم Make owner بدلاً من ذلك.
  • يطلب كل تغيير تأكيداً أولاً ويوضح الصلاحيات التي سيحصل عليها المستخدم بعد التعديل.

Removing Someone, and Leaving

يظهر للمالكين والمسؤولين خيار Remove في جميع الصفوف باستثناء صفوفهم الخاصة وصف المالك. بينما يحتوي صفك الخاص على خيار Leave بدلاً من ذلك، أياً كان دورك.

تؤدي إزالة شخص ما إلى إخراجه من فرق المؤسسة أيضاً، وبالتالي يتوقف فوراً عن الوصول إلى بيانات الاعتماد الخاصة بها. لا يؤثر ذلك على بيانات الاعتماد نفسها: إذ يظل المفتاح أو مستخدم الـ proxy ملكاً للمؤسسة، وليس لمن أنشأه.

لا يمكن إزالة المالك ولا يمكنه المغادرة. يجب نقل ملكية المؤسسة أولاً.

Handing the Organization Over

المالك فقط هو من يستطيع تنفيذ هذا الإجراء. من علامة التبويب Members، انقر على Make owner بجانب الشخص الذي سيتولى الملكية ثم أكد العملية.

تنتقل المؤسسة إلى خطة المالك الجديد: فمنذ تلك اللحظة، يتم احتساب كل طلب تجريه مفاتيح المؤسسة وكل نفق يفتحه مستخدمو الـ proxy خصماً من رصيده، وحركة البيانات الخاصة به، وحدوده، وفاتورته. يصبح المالك السابق مسؤولاً ويحتفظ بجميع صلاحيات الـ admin.

Which Keys You See

جميع المفاتيح المملوكة للمؤسسة مرئية لجميع الأعضاء فيها. ويكمن الاختلاف في الإجراءات المسموح باتخاذها بشأنها:

Action Member Admin Owner
Use the key, reveal it, create new organization keys Yes Yes Yes
Rename it, edit its description Yes Yes Yes
Regenerate, disable, delete No Yes Yes
Move the key out of the organization No No Yes

إعادة تسمية المفتاح أمر غير ضار. بينما تؤدي إعادة إنشائه أو تعطيله إلى إيقاف كل زميل يستخدمه في اللحظة نفسها، ولهذا السبب تقتصر هذه الإجراءات على المسؤولين (admins). يؤدي نقل المفتاح إلى خارج المؤسسة إلى سحب هذا المورد من الشركة ونقل استخدامه إلى خطة المستلم الخاصة، ولهذا السبب يقتصر هذا الإجراء على المالك (owner) وحده.

راجع Managing API Keys للاطلاع على الدليل الكامل.

Which Proxy Users You See

يتبع مستخدم الـ proxy المستويات الثلاثة نفسها للأسباب ذاتها.

Action Member Admin Owner
Use it, read its password, create new ones Yes Yes Yes
New password, disable, delete, change saved targeting No Yes Yes
Transfer it out of the organization No No Yes

يقتصر الاستهداف المحفوظ على المسؤولين بدلا من الأعضاء لأن إعادة توجيهه تؤدي بصمت إلى إعادة توجيه كل اتصال تجريه المؤسسة بأكملها باستخدام بيانات الاعتماد تلك. وتقتصر كلمة المرور الجديدة عليهم لأنها تعطل كل ملف تكوين تم لصق بيانات الاعتماد فيه بالفعل.

يجب ربط برنامج التنزيل الخاص بالشركة بمستخدم proxy تابع للمؤسسة. فالمستخدم الشخصي يتوقف عن العمل في اليوم الذي يغادر فيه ذلك الشخص، وتُحسب التكلفة عليه. راجع Proxy Users للاطلاع على الدليل الإرشادي.

The Owner Filter

بمجرد انضمامك إلى مؤسسة، تظهر قائمة Owner المنسدلة فوق Overview وMetrics وActivity وAPI Keys وProxy. وتتضمن ثلاثة أنواع من الخيارات: Everything وPersonal ومدخلا واحدا لكل مؤسسة. يظل هذا الاختيار محفوظا بين الزيارات ويُطبق على كل صفحة من هذه الصفحات الخمس.

لا تتأثر صفحتا Usage & Limits وBilling بهذا الفلتر عن قصد. فهما تجيبان عن سؤال "ما الذي يُحسب في فاتورتي"، وهو سؤال مختلف عن "ما الذي يمكنني رؤيته": لا يرى العضو حصة المالك أبدا.

Billing Attribution

تُحسب تكلفة كل طلب يتم إجراؤه باستخدام مفتاح مملوك للمؤسسة، وكل نفق يُفتح باستخدام مستخدم proxy مملوك للمؤسسة، على مالك المؤسسة (organization owner) أيا كان من أطلقه. هذا هو السبب الأساسي لنقل بيانات الاعتماد إلى المؤسسة: فهو يغير الطرف الذي يُحتسب الاستخدام عليه بالنسبة للأرصدة، وحركة المرور، وحدود الخطة، والفواتير.

تحسب صفحة Usage & Limits الخاصة بالمالك بيانات اعتماد المؤسسة جنبا إلى جنب مع بيانات اعتماده الشخصية، في تبويب API keys وتبويب Proxy users، وتفصل بين الاثنين ليتضح مصدر الإنفاق بدقة.

Teams

تحصل كل مؤسسة على فريق افتراضي يسمى Everyone. تُحفظ المفاتيح الجديدة فيه تلقائيا ويُضاف إليه كل من ينضم إلى المؤسسة، وهو ما يمنح العضوية إمكانية الوصول إلى المفاتيح.

يسرد تبويب Teams الفرق التي تنتمي إليها، مع دورك في كل منها، وعدد أعضائها، والمفاتيح التي تتيح لك استخدامها (Keys you can use). لم تتوفر بعد إمكانية إنشاء الفرق وتعديلها في لوحة التحكم.

آخر تحديث: 30 سبتمبر 2026
← الفواتير والاشتراكات إعدادات الحساب →