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

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

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

مقدمة

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

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

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

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

• إذا كان لديك حساب مدفوع على 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 للسحابة الإلكترونية العامة، يحتفظ Edge بالعناصر التالية في ذاكرة التخزين المؤقت لمدة 180 ثانية على الأقل بعد الوصول إلى العناصر.

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

إدارة السمات المخصّصة لمطوّر

أضِف ما يصل إلى 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. اطّلِع على ضبط أنواع الفوترة المدفوعة مسبقًا والمدفوعة بعد انتهاء الخدمة باستخدام واجهة برمجة التطبيقات.
الفئة	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 أحرف بعد العلامة العشرية.

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

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

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