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

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

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

مقدمة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إضافة مطوّر

لإضافة مطوّر:

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

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

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

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

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

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

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

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

• رموز الدخول عبر OAuth. يعني ذلك أنّه قد يظل الرمز المميّز الذي تم إبطاله ناجحًا لمدة تصل إلى ثلاث دقائق، إلى أن تنتهي مدة صلاحية ذاكرة التخزين المؤقت.
• كيانات Key Management Service (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	نموذج دفع المطوّر المستخدَم للفوترة يمكن أن تكون القيمة إحدى القيم التالية: PREPAID: يدفع المطوّر مسبقًا مقابل استخدام منتج واجهة برمجة التطبيقات. يتم خصم الأموال من رصيد المطوّر عند استخدام منتج واجهة برمجة التطبيقات. على المطوّر الاحتفاظ برصيد مدفوع مسبقًا يكفي لشراء منتج واجهة برمجة التطبيقات. POSTPAID: يتم تحصيل رسوم استخدام منتجات واجهة برمجة التطبيقات من المطوّر شهريًا (من خلال فاتورة). يدفع المطوّر مقابل استخدام منتجات واجهة برمجة التطبيقات استنادًا إلى شروط الدفع التي تحدّدها الخطط المضمّنة في الفاتورة. BOTH: يتيح هذا الخيار استخدام أي من نوعَي الفوترة. الإعداد التلقائي هو PREPAID. يُرجى الاطّلاع على مقالة ضبط نوعَي الفوترة "الدفع المسبق" و"الدفع عند الاستخدام" باستخدام واجهة برمجة التطبيقات.
الفئة	MINT_DEVELOPER_CATEGORY	فئة المطوّر التي تريد إضافة المطوّر إليها فئة المطوّر هي مجموعة من المطوّرين أو الشركات ذات الخصائص المتشابهة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إدارة فئات المطوّرين.
رقم تعريف الشركة	MINT_COMPANY_ID	رقم تعريف الشركة، إن وُجد لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تجميع المطوّرين في شركات.
نوع المطوّر	MINT_DEVELOPER_TYPE	لا تستخدم Apigee هذه السمة. نوع المطوّر تشمل القيم الصالحة: TRUSTED أو UNTRUSTED
وسيط	MINT_IS_BROKER	علامة تحدّد ما إذا كانت الإيرادات تستند إلى صافي الإيرادات
الاسم القانوني	MINT_DEVELOPER_LEGAL_NAME	الاسم القانوني للمطوّر الذي سيتم استخدامه في جميع التقارير ملاحظة: هذه السمة مطلوبة إذا لم يتم تجميع المطوّر مع شركة وأراد الاشتراك في خطة معدّل منشورة.
الفوترة الذاتية	MINT_HAS_SELF_BILLING	علامة تحدّد ما إذا كانت الفواتير الذاتية مفعّلة إذا كانت هذه العلامة مفعّلة (true)، تنشئ ميزة تحقيق الربح فاتورة ذاتية بدلاً من بيان مشاركة الإيرادات. الفاتورة الذاتية هي مستند مالي يوضّح المبلغ المستحق للمطوّر. وهي بمثابة فاتورة لمزوّد واجهة برمجة التطبيقات نيابةً عن المطوّر.
رقم الإذن بالإعفاء الضريبي	MINT_TAX_EXEMPT_AUTH_NO	رقم الإعفاء الضريبي الحكومي، إن وُجد
قيمة الضريبة	MINT_APPROX_TAX_RATE	قيمة الضريبة التقريبية للمطوّر يجب تحديد قيمة عشرية بحد أقصى 3 أحرف قبل العلامة العشرية و4 أحرف بعدها.

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

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

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