تسجيل مطوّري التطبيقات

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

تسجيل مطوّري التطبيقات وإدارتهم، كما هو موضَّح في الأقسام التالية (عملية تسجيل التطبيق هي عملية منفصلة، كما هو موضّح في تسجيل التطبيقات وإدارة مفاتيح واجهة برمجة التطبيقات).

مقدمة

توفّر Edge العديد من المزايا التي تعتمد بشكل كامل على معرفة هوية الجهة التي تستدعي واجهات برمجة التطبيقات. على سبيل المثال، يعتمد أمان واجهة برمجة التطبيقات وإدارة عدد الزيارات وكمية معقولة من بيانات الإحصاءات على معرفة هوية الجهة التي تجري الاتصال. وكيف يعرف Edge هوية الجهة التي تستدعي واجهات برمجة التطبيقات؟ من خلال قراءة معلومات فريدة في كل طلب بيانات من واجهة برمجة التطبيقات، مثل رقم تعريف المستخدم أو مفتاح واجهة برمجة التطبيقات أو رمز OAuth المميز. تؤدي هذه المعلومات الفريدة إلى قفل أو فتح الوظائف التي تنشئها في خوادم وكيل واجهة برمجة التطبيقات، ما يمنحك تحكّمًا كاملاً في إمكانية الوصول إلى واجهة برمجة التطبيقات وسلوكها.

لهذا السبب، على مطوّري التطبيقات التسجيل لاستخدام واجهات برمجة التطبيقات. بعد إضافة التطبيقات، يسجِّل المطوّرون تطبيقاتهم ويختارون واجهات برمجة التطبيقات التي يريدون استخدامها ويتلقّون بيانات اعتماد فريدة لواجهة برمجة التطبيقات (مفاتيح المستهلكين وأسرارهم) اللازمة للوصول إلى واجهات برمجة التطبيقات.

كيفية تسجيل مطوّري التطبيقات

سجِّل مطوّري التطبيقات باستخدام إحدى الطرق التالية:

• إذا كان لديك حساب Edge مدفوع، يمكن للمطوّرين التسجيل الذاتي من خلال بوابة مخصّصة للمطوّرين. لمزيد من المعلومات، يُرجى الاطّلاع على أحد الأقسام التالية استنادًا إلى نوع بوابة مخصّصة للمطوّرين:
  • البوابة المدمجة: إنشاء حساب مطوِّر على البوابة المدمجة
  • ‫Drupal 10: تسجيل حساب مطوّر تطبيقات
  • ‫Drupal 7: إضافة حسابات المستخدمين وإدارتها
• يمكن للمشرفين تسجيل مطوّري التطبيقات باستخدام واجهة برمجة التطبيقات.
• بصفتك مشرفًا على بوابة مخصّصة للمطوّرين، يمكنك إدارة المطوّرين مباشرةً على البوابة، كما هو موضّح في الأقسام التالية:
  • البوابة المتكاملة: إدارة حسابات المطوِّرين لإدارة حسابات المطوِّرين
  • ‫Drupal 10: كيفية تفاعل مطوّري التطبيقات مع وحدة Apigee Edge
  • ‫Drupal 7: إضافة حسابات المستخدمين وإدارتها
• بصفتك مشرفًا في المؤسسة، يمكنك إدارة المطوّرين باستخدام واجهة المستخدم أو واجهة برمجة التطبيقات في Edge، كما هو موضّح في الأقسام التالية.

اقتراحات لإدارة حسابات المطوِّرين على بوابات المطوِّرين

تنصح Apigee بإدارة حسابات المطوّرين مباشرةً على بوابة مخصّصة للمطوّرين.

إذا كنت تستخدم البوابة المدمجة، هذه هي الطريقة الوحيدة لضمان بقاء حسابات المطوّرين على البوابة المدمجة وEdge متزامنة.

إذا كنت تستخدم بوابة المطوّرين المستندة إلى Drupal، فإنّ إدارة حسابات المطوّرين مباشرةً على بوابة المطوّرين توفّر المزايا التالية:

• عند إضافة مطوّر من خلال واجهة المشرف في البوابة، يمكنك ضبط كلمة مرور المطوّر للبوابة وتفعيل رسالة إلكترونية تلقائية يتم إرسالها إلى المطوّر.

  عند إضافة مطوّر أو تعديله باستخدام Edge، لا يتم إرسال رسالة إلكترونية إلى المطوّر ولا يمكنك ضبط كلمة المرور الخاصة به في البوابة. لذلك، على المطوّر إعادة ضبط كلمة المرور على البوابة قبل أن يتمكّن من تسجيل الدخول إليها.

• يتم تلقائيًا إرسال أي تغييرات يتم إجراؤها على حساب المطوّر في البوابة إلى Edge.

إذا قرّرت إدارة حسابات المطوّرين المستندة إلى Drupal باستخدام Edge، عليك مزامنة مطوّري التطبيقات بين البوابة وEdge.

استكشاف صفحة "المطوّرين"

الوصول إلى صفحة "المطوّرون" واستكشافها باستخدام واجهة مستخدم Edge وواجهة مستخدم Edge الجديدة

إضافة مطوِّر

لإضافة مطوِّر، اتّبِع الخطوات التالية:

1. انتقِل إلى صفحة "المطوّرون".
2. انقر على + مطوِّر.
3. أدخِل تفاصيل المطوّر، بما في ذلك الاسم الأول واسم العائلة والبريد الإلكتروني واسم المستخدم.
4. انقر على إنشاء.

عرض تفاصيل المطوّر وتعديلها

عرض تفاصيل المطوِّر وتعديلها بالنسبة إلى المؤسسات التي فعّلت ميزة تحقيق الربح، يمكنك تعديل سمات تحقيق الربح المخصّصة المحدّدة في ضبط سمات تحقيق الربح.

لعرض تفاصيل المطوِّر وتعديلها، اتّبِع الخطوات التالية:

1. انتقِل إلى صفحة "المطوّرون".
2. انقر على صف المطوِّر الذي تريد الاطّلاع عليه وتعديله لفتح تفاصيل المطوِّر.
3. في قسم "التفاصيل"، يتم عرض المعلومات التالية. عدِّل تفاصيل المطوِّر حسب الحاجة.

   التفصيل	الوصف
   التفاصيل	الاسم الأول واسم العائلة واسم المستخدم والبريد الإلكتروني للمطوِّر وحالة التسجيل ومدته ورقم تعريف المطوِّر لتعديل تفاصيل المطوّر، انقر داخل أي من الحقول التالية: الاسم الأول اسم العائلة البريد الإلكتروني اسم المستخدم عدِّل المحتوى واضغط على Enter لتأكيد التغيير.
   سمات مخصصة	سمات مخصّصة تم تحديدها للمطوّر اضبط السمات المخصّصة حسب الحاجة. لمزيد من المعلومات، يُرجى الاطّلاع على: إدارة السمات المخصّصة لأحد المطوّرين ضبط سمات تحقيق الربح
   التطبيقات	التطبيقات التي سجّلها المطوّر اطّلِع على تسجيل التطبيقات.

4. فعِّل المطوّر أو أوقِفه في حقل "الحالة".
   لمزيد من المعلومات، اطّلِع على تفعيل حساب مطوّر أو إيقافه.

باستخدام Apigee Edge for Public Cloud، يحتفظ Edge بالكيانات التالية في ذاكرة التخزين المؤقت لمدة 180 ثانية على الأقل بعد الوصول إلى الكيانات.

• رموز الدخول عبر OAuth وهذا يعني أنّه قد ينجح استخدام رمز مميّز تم إبطاله لمدة تصل إلى ثلاث دقائق، إلى أن تنتهي مدة صلاحية الحد الأقصى لذاكرته المؤقتة.
• عناصر خدمة إدارة المفاتيح (KMS) (التطبيقات والمطوّرون ومنتجات واجهة برمجة التطبيقات)
• سمات مخصّصة على رموز OAuth المميزة وعناصر KMS

إدارة السمات المخصّصة لأحد المطوّرين

أضِف ما يصل إلى 18 سمة مخصّصة لكل مطوّر، بما في ذلك سمات تحقيق الربح الموضّحة في مقالة إعداد سمات تحقيق الربح.

لإدارة السمات المخصّصة، اتّبِع الخطوات التالية:

1. انتقِل إلى صفحة "المطوّرون".
2. انقر على صف المطوِّر الذي تريد إدارة السمات المخصّصة له لفتح تفاصيل المطوِّر.
3. انقر على + في قسم "السمات المخصّصة".
4. أدخِل اسم السمة وقيمتها.
5. انقر على .
6. لحذف سمة مخصّصة، ضَع مؤشر الماوس فوق السمة وانقر على في قائمة الإجراءات.

تفعيل حساب مطوِّر وإيقافه

عندما يسجّل مطوّر تطبيق نفسه في البوابة، يمكنك ضبط ما إذا كان نشطًا تلقائيًا أم لا.

عندما يكون المطوّر غير نشط، يظل بإمكانه تسجيل الدخول إلى "بوابة مخصّصة للمطوّرين" وإنشاء تطبيقات، ولكن لن يعمل أي من مفاتيح واجهة برمجة التطبيقات المرتبطة به. ستظل تطبيقات المطوّر تحتفظ بحالتها المعتمَدة (أو غيرها)، وكذلك مفاتيح واجهة برمجة التطبيقات، على الرغم من أنّها غير صالحة أثناء عدم نشاط المطوّر.

لتفعيل حساب مطوِّر أو إيقافه، اتّبِع الخطوات التالية:

1. انتقِل إلى صفحة "المطوّرون".
2. انقر على صف المطوّر الذي تريد تفعيله أو إيقافه لفتح تفاصيل المطوّر.
3. في قسم "التفاصيل"، اضبط حقل الحالة على نشط أو غير نشط، حسب الحاجة.
4. كرِّر الخطوات إذا كان المطوِّر في مؤسسات متعددة.

تصدير بيانات النشر

صدِّر بيانات النشر التالية كملف قيم مفصولة بفواصل (CSV):

• تفاصيل المطوِّر
• تفاصيل المطوِّر والتطبيق ومنتج واجهة برمجة التطبيقات

لتصدير بيانات النشر، اتّبِع الخطوات التالية:

1. انتقِل إلى صفحة "المطوّرون".
2. انقر على تصدير ملف CSV...
3. اختَر المطوّرون أو المطوّرون والتطبيقات والمنتجات من القائمة المنسدلة.

يتم تنزيل بيانات النشر المحدّدة كملف CSV.

حذف مطوِّر

لحذف مطوِّر، اتّبِع الخطوات التالية:

1. انتقِل إلى صفحة "المطوّرون".
2. ضَع مؤشر الماوس فوق صف المطوّر الذي تريد حذفه لعرض قائمة الإجراءات.
3. انقر على .
4. انقر على حذف لتأكيد الحذف.

مزامنة مطوّري التطبيقات بين البوابة وEdge

إذا كنت تستخدم بوابة مخصّصة للمطوّرين مستندة إلى Drupal لنشر واجهات برمجة التطبيقات، لن يتم نقل التغييرات التي يتم إجراؤها على مطوّري التطبيقات باستخدام Edge إلى البوابة. يجب تسجيل الدخول إلى البوابة بصفتك مشرفًا على البوابة ومزامنة البوابة مع Edge لكي تظهر هذه التغييرات على البوابة.

.

لمزامنة بوابة مخصّصة للمطوّرين مع مطوّري التطبيقات المحدّدين على Edge، يُرجى الرجوع إلى الأقسام التالية:

• ‫Drupal 10: مزامنة المطوّرين مع Apigee Edge
• ‫Drupal 7: مزامنة مطوّري التطبيقات بين البوابة وEdge

تجميع المطوّرين في شركات

في ما يتعلّق بتحقيق الربح، تكون الشركة مجموعة من المطوّرين تتم إدارتهم ككيان واحد. يمكن أن تكون الشركة أي مجموعة مناسبة لمؤسستك، مثل وحدة تجارية أو مجموعة المنتجات أو قسم. يفيد تجميع المطوّرين في شركات عندما تحتاج إلى ربط عدة مطوّرين بكيان مؤسسي واحد. على سبيل المثال، قد تحتاج إلى إعداد شركات مختلفة لأغراض الفوترة. ومع ذلك، ليس من الضروري أن يكون المطوّرون في مؤسستك مرتبطين بشركة. يُرجى العِلم أنّ المطوِّر هو دائمًا كيان واحد، يتم تعريفه بشكل فريد من خلال عنصر البريد الإلكتروني. إذا كان المطوّر جزءًا من شركة، سيظهر اسم الشركة في صفحة "المطوّرون".

لمزيد من المعلومات حول إدارة الشركات والمطوّرين لتحقيق الربح، يُرجى الاطّلاع على مقالة إدارة الشركات والمطوّرين.

ضبط سمات تحقيق الربح

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

اسم الحقل	اسم السمة المخصّصة	الوصف
العنوان	MINT_DEVELOPER_ADDRESS	عنوان المطوّر، بما في ذلك الحقول التالية: العنوان (السطر 1 والسطر 2) والمدينة والولاية والرمز البريدي والبلد
ملف الفوترة	MINT_BILLING_PROFILE	دورة الفوترة لمؤسستك تشمل القيم الصالحة ما يلي: PRORATED: تستند الفوترة إلى عدد الأيام التي يتم فيها استخدام أحد منتجات واجهة برمجة التطبيقات في شهر تقويمي. ‫CALENDAR_MONTH: تتم الفوترة شهريًا.
نوع الفوترة	MINT_BILLING_TYPE	نموذج الدفع للمطوّر المستخدَم في الفوترة يمكن أن تكون القيمة إحدى القيم التالية: الدفع المُسبَق: يدفع المطوّر مُسبقًا مقابل استخدام أحد منتجات واجهة برمجة التطبيقات. يتم خصم الأموال من رصيد المطوّر عند استخدام منتج واجهة برمجة التطبيقات. يجب أن يحتفظ المطوّر برصيد الدفع المسبق كافٍ لشراء منتج واجهة برمجة التطبيقات. POSTPAID: يتم إصدار فواتير شهرية (من خلال فاتورة) للمطوّر مقابل استخدام منتجات واجهة برمجة التطبيقات. يدفع المطوّر مقابل استخدام منتجات واجهة برمجة التطبيقات استنادًا إلى بنود الدفع التي تحدّدها الخطط المضمَّنة في الفاتورة. BOTH: يمكن استخدام أيّ من نوعَي الفوترة. القيمة التلقائية هي PREPAID. اطّلِع على ضبط أنواع الفوترة المدفوعة مسبقًا والدفع عند الاستخدام باستخدام واجهة برمجة التطبيقات.
الفئة	MINT_DEVELOPER_CATEGORY	فئة المطوّر التي تريد إضافة المطوّر إليها فئة المطوّرين هي مجموعة من المطوّرين أو الشركات الذين يتشاركون سمات متشابهة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إدارة فئات المطوّرين.
رقم تعريف الشركة	MINT_COMPANY_ID	معرّف الشركة، إذا كان ذلك منطبقًا لمزيد من المعلومات، يُرجى الاطّلاع على تجميع المطوّرين في شركات.
نوع المطوِّر	MINT_DEVELOPER_TYPE	لا تستخدم Apigee هذه السمة. نوع المطوِّر تشمل القيم الصالحة: TRUSTED أو UNTRUSTED
Is Broker	MINT_IS_BROKER	علامة تحدّد ما إذا كان الربح يستند إلى صافي الأرباح.
الاسم القانوني	MINT_DEVELOPER_LEGAL_NAME	الاسم القانوني للمطوّر الذي سيتم استخدامه في جميع التقارير ملاحظة: هذه السمة مطلوبة إذا لم يكن المطوّر تابعًا لشركة ويريد الاشتراك في خطة أسعار منشورة.
الفوترة الذاتية	MINT_HAS_SELF_BILLING	علامة تحدّد ما إذا كانت فواتير الفوترة الذاتية مفعّلة. في حال تفعيل هذه الميزة (true)، سيتم إنشاء فاتورة ذاتية بدلاً من بيان مشاركة الأرباح. فاتورة الفوترة الذاتية هي مستند مالي يوضّح المبلغ المستحق للمطوّر. وهي تعمل كفاتورة مقدَّمة إلى مقدّم خدمة واجهة برمجة التطبيقات نيابةً عن المطوّر.
رقم تفويض الإعفاء الضريبي	MINT_TAX_EXEMPT_AUTH_NO	تمثّل هذه السمة رقم الإعفاء الضريبي الحكومي، إذا كان ذلك منطبقًا.
قيمة الضريبة	MINT_APPROX_TAX_RATE	معدّل الضريبة التقريبي للمطوّر حدِّد قيمة عشرية تتضمّن 3 أحرف كحدّ أقصى قبل العلامة العشرية و4 أحرف كحدّ أقصى بعدها.

إدارة المطوّرين باستخدام واجهة برمجة التطبيقات

إدارة المطوّرين باستخدام واجهات برمجة التطبيقات للمطوّرين

عند إنشاء حساب مطوِّر وتعديله باستخدام واجهة برمجة التطبيقات، يمكنك ضبط سمات تحقيق الربح الموضّحة في إعداد سمات تحقيق الربح، حسب الحاجة.