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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

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

مقدمة

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

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

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

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

• إذا كان لديك حساب مدفوع على Edge، يمكن للمطوّرين التسجيل بأنفسهم من خلال بوابة المطوّرين. لمزيد من المعلومات، يمكنك الاطّلاع على أحد الأقسام التالية استنادًا إلى نوع بوابة المطوّرين:
  • البوابة المتكاملة: إنشاء حساب مطوّر على البوابة المدمجة
  • Drupal 9: تسجيل حساب مطوِّر تطبيقات
  • Drupal 7: إضافة حسابات مستخدمين وإدارتها
• يمكن للمشرفين تسجيل مطوّري التطبيقات باستخدام واجهة برمجة التطبيقات.
• بصفتك مشرفًا لبوابة المطوّرين، يمكنك إدارة المطوّرين مباشرةً على بوابة الويب الخاصة بك، كما هو موضّح في الأقسام التالية:
  • البوابة المدمجة: إدارة حسابات مطوّري البرامج لإدارة حسابات المطوّرين
  • Drupal 9: كيفية تفاعل مطوّري التطبيقات مع وحدة Apigee Edge
  • Drupal 7: إضافة حسابات مستخدمين وإدارتها
• بصفتك مشرفًا في مؤسسة، يمكنك إدارة المطوّرين باستخدام واجهة مستخدم أو API في 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 9: مزامنة المطوّرين مع Apigee Edge
• Drupal 7: مزامنة مطوّري التطبيقات بين البوابة وEdge

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

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

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

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

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

اسم الحقل	اسم السمة المخصّصة	الوصف
العنوان	MINT_DEVELOPER_ADDRESS	عنوان المطوّر، بما في ذلك الحقول التالية: العنوان (السطران 1 و2) والمدينة والولاية والرمز البريدي والبلد
الملف الشخصي للفوترة	MINT_BILLING_PROFILE	دورة الفوترة لمؤسستك وتشمل القيم الصالحة ما يلي: PRORATED: تستند الفوترة إلى عدد الأيام التي يتم فيها استخدام منتج واجهة برمجة التطبيقات في شهر تقويمي معيّن. CALENDAR_MONTH: تتم الفوترة شهريًا.
نوع الفوترة	MINT_BILLING_TYPE	نموذج الدفع الخاص بالمطوّر والمستخدَم للفوترة يمكن أن تكون القيمة واحدة مما يلي: PREPAID: يدفع المطوّر رسومًا مُسبقًا مقابل استخدام منتج واجهة برمجة التطبيقات. ويتم خصم الأموال من رصيد المطوّر عند استخدام منتج واجهة برمجة التطبيقات. يجب أن يحتفظ مطوِّر البرامج برصيد مدفوع مسبقًا يكفي لشراء منتج واجهة برمجة التطبيقات. POSTPAID: يتم تحصيل فاتورة من مطوّر البرامج شهريًا (من خلال فاتورة) مقابل استخدام منتجات واجهة برمجة التطبيقات. يدفع المطوّر مقابل استخدام منتجات واجهة برمجة التطبيقات استنادًا إلى بنود الدفع المحدّدة في الخطط المضمَّنة في الفاتورة. كلا نوعي الفوترة: يدعم أي من نوعي الفوترة. يكون الإعداد التلقائي هو 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 أحرف بعد العلامة العشرية.

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

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

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