يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
تتيح بوابة المطوّرين لمطوّري التطبيقات تسجيل التطبيقات التي ستستهلك واجهات برمجة التطبيقات، وتسجيل الدخول إليها، وإدارتها.
توضّح الأقسام التالية كيفية تفاعل مطوّري التطبيقات مع البوابة:
كيفية تتبُّع تسجيل مطوّري التطبيق وتسجيل الدخول إليه في Edge
يتم تتبُّع تسجيل المطوّر وتسجيل الدخول إلى البوابة باستخدام السمة المخصّصة _apiportal في Edge.
عندما يسجّل المطوّر نفسه، تتم إضافة السمة _apiportal المخصّصة إلى إعدادات المطوّر ويتم ضبط حالة المطوّر على unverified للإشارة إلى أنّ المطوّر لم يسجّل الدخول إلى المنصة. مثال: {"status":"unverified","portals":{}}
في المرة الأولى التي يسجّل فيها المطوّر الدخول إلى بوابة، يتم تعديل السمة المخصّصة _apiportal لتتبُّع اسم البوابة ووقت الدخول، وضبط حالة المطوّر على active. في كل مرة يسجِّل فيها المطوّر الدخول إلى البوابة، يتم تعديل السمة المخصّصة لإعادة ضبط قيمة lastVisit (بتنسيق الحقبة) لتلك البوابة. مثال: {"status":"active","portals":{"myorg-myportal":{"lastVisit":1480972935}}}
تسجيل حساب مطوِّر تطبيقات
قبل أن يتمكن مطورو التطبيقات من استخدام واجهات برمجة التطبيقات، عليهم التسجيل من خلال إنشاء حساب.
عندما يسجّل مطوّر برامج في بوابة الويب الخاصة بك:
- يتم إنشاء معلومات مطوِّر التطبيقات وتخزينها على Edge. الاطّلاع على مكان تخزين معلومات حساب المطوّر
- يظهر مطوِّر التطبيقات في قائمة مطوّري التطبيقات المسجَّلين. يُرجى الاطّلاع على صفحة استكشاف المطوّرين.
بدلاً من ذلك، يمكنك تسجيل مطوري التطبيقات نيابةً عنهم باستخدام واجهة مستخدم Edge، كما هو موضح في تسجيل مطوري التطبيقات.
يمكن لمطوّري التطبيقات الجدد التسجيل بأنفسهم من خلال البوابة على النحو التالي:
- انتقِل إلى البوابة.
- انقر على تسجيل الدخول.
انقر على اشتراك.
سيظهر مربّع الحوار التالي.
أدخِل المعلومات المطلوبة (الاسم الأول واسم العائلة وعنوان البريد الإلكتروني).
انقر على إنشاء.
سيظهر مربّع الحوار التالي.
انقر على الرابط الآمن في الرسالة الإلكترونية لفتح البوابة وإنشاء الجلسة التي تمت المصادقة عليها.
تسجيل الدخول إلى البوابة
بعد تسجيل مطوّري التطبيقات في البوابة، يمكنهم تسجيل الدخول باستخدام صفحة "تسجيل الدخول".
في كل مرة يسجِّل فيها مطوّر تطبيقات الدخول إلى بوابة، بدلاً من استخدام مفتاح سري مشترك مثل كلمة مرور لمصادقة المطوِّر، يتم إرسال رابط آمن لإثبات الهوية وإنشاء جلسة مع البوابة.
يمكن لمطوّري التطبيقات تسجيل الدخول إلى البوابة، كما يلي:
- انتقِل إلى البوابة.
- انقُر على تسجيل الدخول.
- أدخِل عنوان البريد الإلكتروني المرتبط بالحساب.
انقر على تسجيل الدخول.
سيظهر مربّع الحوار التالي.
انقر على الرابط الآمن في الرسالة الإلكترونية لفتح البوابة وإنشاء الجلسة التي تمت المصادقة عليها.
تسجيل التطبيقات
بعد تسجيل الدخول إلى البوابة، يمكن لمطوّري التطبيقات تسجيل التطبيقات لاستخدام منتجات واجهة برمجة التطبيقات التي نشرتها، كما يلي:
- حدد تطبيقاتي من القائمة المنسدلة للمستخدم.
- انقر على + تطبيق لإنشاء تطبيق جديد.
- أدخل اسمًا ووصفًا للتطبيق في مربع الحوار "إنشاء تطبيق".
- انقر على إنشاء.
- يمكنك إدارة منتجات واجهة برمجة التطبيقات في التطبيق، كما هو موضَّح أدناه.
إدارة منتجات واجهة برمجة التطبيقات في أحد التطبيقات
يمكن لمطوّري التطبيقات إدارة منتجات واجهة برمجة التطبيقات في تطبيقاتهم. وتتم إضافة منتجات واجهة برمجة التطبيقات إلى صفحة تفاصيل التطبيق. لا يتم تطبيق الموافقة تلقائيًا على بعض منتجات واجهة برمجة التطبيقات. تشير الحالة في انتظار المراجعة إلى منتج واجهة برمجة التطبيقات الذي تم طلب الوصول إليه، ولكن لم يتم منحه بعد.
يمكن لمطوّري التطبيقات إدارة منتجات واجهة برمجة التطبيقات في أحد التطبيقات من البوابة على النحو التالي:
- حدد تطبيقاتي من القائمة المنسدلة للمستخدم.
- انقر على اسم التطبيق.
- انقر على إدارة المنتجات.
انقر على مفتاح التبديل الوصول لتفعيل إمكانية الوصول إلى منتج واجهة برمجة التطبيقات أو إيقافه من التطبيق.
ملاحظة: إذا أوقف مطوِّر التطبيق إمكانية الوصول إلى منتج واجهة برمجة التطبيقات الذي يكون خاصًا أو داخليًا فقط، ستتم إزالة منتج واجهة برمجة التطبيقات من التطبيق ويجب أن يضيفه مشرف البوابة يدويًا كما هو موضَّح في تسجيل التطبيقات وإدارة مفاتيح واجهة برمجة التطبيقات.
انقر على طلب لطلب الموافقة على منتج واجهة برمجة تطبيقات غير مسموح به بعد.
انقر على حفظ.
عرض مفتاح واجهة برمجة التطبيقات لتطبيق
يمكن لمطوّري التطبيقات إدارة مفتاح واجهة برمجة التطبيقات لأحد التطبيقات من البوابة الخاصة بك، وذلك على النحو التالي:
- حدد تطبيقاتي من القائمة المنسدلة للمستخدم.
- انقر على اسم التطبيق.
- يمكنك الاطّلاع على مفتاح واجهة برمجة التطبيقات في قسم المفاتيح.
- انقر على عرض السر لعرض المفتاح السرّي لواجهة برمجة التطبيقات.
- تأكَّد من أنّ حالة مفتاح واجهة برمجة التطبيقات "موافَق عليها".
تدوير مفتاح واجهة برمجة التطبيقات لأحد التطبيقات
يمكن لمطوِّر التطبيقات تدوير مفتاح واجهة برمجة التطبيقات للتطبيق بشكل دوري أو استجابة لتسريب محتمل أو اختراق. عندما يبدِّل أحد مطوّري التطبيقات مفتاح واجهة برمجة التطبيقات، يتم إنشاء مفتاح واجهة برمجة تطبيقات جديد يتضمن استحقاقات منتجات واجهة برمجة التطبيقات نفسها مثل المفتاح الأصلي. يتم وضع علامة على مفتاح واجهة برمجة التطبيقات الأصلي باعتباره متوقفًا، ولكنّه يظل نشطًا أثناء نقله خارج نطاق الاستخدام. عليك إيقاف مفتاح تم إيقافه لمنع قبول بيانات الاعتماد الخاصة به، كما هو موضّح في المقالة إيقاف مفتاح واجهة برمجة تطبيقات لأحد التطبيقات.
يمكن لمطوّري التطبيقات تغيير مفتاح واجهة برمجة التطبيقات الأساسي لأحد التطبيقات من البوابة، وذلك على النحو التالي:
- حدد تطبيقاتي من القائمة المنسدلة للمستخدم.
- انقر على اسم التطبيق.
- في قسم "المفاتيح"، ضع المؤشر على مفتاح واجهة برمجة التطبيقات الحالي لعرض قائمة الإجراءات.
- انقر على
لتوسيع قائمة الإجراءات. - انقر على تدوير.
- انقر على إنشاء في مربّع الحوار لتأكيد العملية.
- يمكنك اختياريًا إيقاف مفتاح واجهة برمجة التطبيقات، كما هو موضّح أدناه.
إيقاف مفتاح واجهة برمجة التطبيقات لتطبيق
عندما يبدِّل مطوّر التطبيق مفتاح واجهة برمجة التطبيقات، كما هو موضَّح في القسم السابق، يتم وضع علامة على مفتاح واجهة برمجة التطبيقات على أنّه متوقّف نهائيًا، ولكنّه يظل نشطًا حتى عندما تنقله عن الاستخدام. يجب إيقاف مفتاح تم إيقافه لمنع قبول بيانات اعتماده.
يمكن لمطوّري التطبيقات إيقاف مفتاح واجهة برمجة تطبيقات لتطبيق من البوابة، وذلك على النحو التالي:
- حدد تطبيقاتي من القائمة المنسدلة للمستخدم.
- انقر على اسم التطبيق.
- في قسم المفاتيح، انقر على سجلّ المفاتيح لعرض قائمة المفاتيح المتوقّفة نهائيًا.
- ضع مؤشر الماوس فوق مفتاح واجهة برمجة التطبيقات الذي تم إيقافه نهائيًا والذي تريد إيقافه لعرض قائمة الإجراءات.
- انقر على لتوسيع قائمة الإجراءات.
- النقر على إيقاف
- انقر على إيقاف لتأكيد العملية.
تم تعديل حالة المفتاح إلى "تم الإبطال".
تعديل تفاصيل التطبيق
يمكن لمطوّري التطبيقات تعديل تفاصيل التطبيق على النحو التالي:
- حدد تطبيقاتي من القائمة المنسدلة للمستخدم.
- انقر على اسم التطبيق.
- عدِّل حقلَي "الاسم" أو "الوصف".
- انقر على حفظ.
يتم حذف التطبيق وإزالته من قائمة "تطبيقاتي".
حذف تطبيق
يمكن لمطوّري التطبيقات حذف تطبيق من بوابة الويب الخاصة بك، كما يلي:
- حدد تطبيقاتي من القائمة المنسدلة للمستخدم.
- انقر على اسم التطبيق.
- انقر على حذف في أعلى يسار الصفحة.
يتم حذف التطبيق وإزالته من قائمة "تطبيقاتي".