مسرد المصطلحات

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

هناك العديد من المفاهيم الشائعة التي لها معنى مختلف في Apigee.

المصطلح	التعريف
واجهة برمجة التطبيقات	خادم وكيل يعمل كواجهة لواجهة برمجة التطبيقات الحالية بدلاً من طلب بيانات من واجهة برمجة التطبيقات الحالية، يبدأ المطوّرون في طلب بيانات من واجهة برمجة التطبيقات الجديدة التي أنشأتها Apigee. تفصل هذه الواجهة بين الواجهة العامة وواجهة برمجة التطبيقات في الخلفية، ما يحمي المطوّرين من التغييرات في الخلفية، مع السماح لك بالابتكار في المقدّمة بدون التأثير في فِرق التطوير الداخلية. أثناء إجراء تغييرات على الخلفية، يواصل المطوّرون طلب البيانات من واجهة برمجة التطبيقات نفسها بدون انقطاع. في السيناريوهات الأكثر تقدمًا، تتيح لك Apigee عرض واجهات متعددة لواجهة برمجة التطبيقات نفسها، ما يحرّرك لتخصيص توقيع واجهة برمجة التطبيقات لتلبية احتياجات مجالات المطوّرين المختلفة في الوقت نفسه.
المسار الأساسي لواجهة برمجة التطبيقات والموارد	تتكوّن واجهة برمجة التطبيقات من مسار أساسي ومجموعة من الموارد (المعروفة أيضًا باسم مسارات الموارد). لكل واجهة برمجة تطبيقات، يمكنك تحديد عنوان URL جذر واحد ومسارات موارد متعددة. يمكنك اعتبار واجهة برمجة التطبيقات ببساطة مجموعة من عناوين URL التي تتشارك كلها مسارًا أساسيًا مشتركًا. لتسهيل إدارة واجهات برمجة التطبيقات، تُضيف Apigee عناوين URL الأوّلية هذه مع الأسماء المعروضة والأوصاف.
مستخدِم واجهة برمجة التطبيقات	يُستخدَم هذا المصطلح بالتبادل مع "مطوّر التطبيقات" الذي يستخدم واجهات برمجة التطبيقات التي أنشأها موفِّر واجهة برمجة التطبيقات.
مطوّر واجهة برمجة التطبيقات	مهندس برمجيات في مؤسسة موفّرة لواجهات برمجة التطبيقات ينشئ واجهات برمجة التطبيقات يستخدم مطوّرو التطبيقات (مستخدِمو واجهات برمجة التطبيقات) واجهات برمجة التطبيقات هذه لإنشاء التطبيقات.
حزمة واجهة برمجة التطبيقات	مجموعة من منتجات واجهات برمجة التطبيقات التي يتم تقديمها للمطوّرين كمجموعة، وتكون عادةً مرتبطة بخطة أسعار.
منتج واجهة برمجة التطبيقات	مجموعة من موارد واجهة برمجة التطبيقات (معرّفات URI) مع خطة خدمة يتم تقديمها للمطوّرين كمجموعة. يمكن أن يتضمّن منتج واجهة برمجة التطبيقات أيضًا بعض البيانات الوصفية الخاصة بنشاطك التجاري للتتبّع أو الإحصاءات. يمكن تحقيق الربح من مورد واحد أو أكثر من خلال تضمينه في منتج لواجهة برمجة التطبيقات، والذي يمكن تجميعه بعد ذلك في حزمة لواجهة برمجة التطبيقات لتحقيق الربح.
موفِّر واجهة برمجة التطبيقات	ينشئ موفِّر واجهة برمجة التطبيقات واجهات برمجة التطبيقات (باستخدام Edge) ليستخدمها مستخدِمو واجهات برمجة التطبيقات (مطوّرو التطبيقات).
مطوّر التطبيقات	في Edge، يسجِّل مطوّرو التطبيقات تطبيقاتهم لدى موفّر واجهة برمجة التطبيقات، وهي الطريقة التي يحصل بها مطوّرو التطبيقات على مفاتيح واجهة برمجة التطبيقات التي يحتاجونها للاتّصال بخدمات الوكيل لواجهة برمجة التطبيقات لدى الموفّر.
التطبيقات	يستخدم المطوّرون التطبيقات للوصول إلى المراجع في منتجات واجهات برمجة التطبيقات. عند إنشاء تطبيق، يمكنك اختيار منتج واجهة برمجة التطبيقات المطلوب تضمينه، وتنشئ Apigee مفتاحًا. يحتوي كل تطبيق على مفتاح واحد يتيح الوصول إلى منتجات متعددة من واجهات برمجة التطبيقات. تتيح لك التطبيقات التحكّم في المستخدمين الذين يمكنهم الوصول إلى مواردك. يمكنك التحكّم في المستخدمين الذين يمكنهم الوصول إلى منتجات واجهة برمجة التطبيقات من خلال إبطال مفتاح التطبيق وتجديده. ويمكنك التحكّم في الوصول إلى حِزم الموارد من خلال إبطال إذن الوصول إلى المنتجات في أحد التطبيقات أو حذفه.
تفاصيل الرصيد	بالنسبة إلى المطوّر الذي يستخدم اشتراكًا مدفوعًا مسبقًا، يكون الرصيد في حساب المطوّر.
التعديل المغلق	تعديل تم تطبيقه في مستندات الفوترة المنشورة.
شهر الفوترة المغلق	شهر تقويمي كامل تم نشر مستندات الفوترة له.
الحدّ الأقصى المخصّص	حدّ (مثل حدّ لعدد المعاملات في منتج واجهة برمجة التطبيقات) يمكنك إعداده صراحةً باستخدام ميزة تحقيق الربح ويُعرف أيضًا باسم الحدّ الصريح.
خطة الأسعار حسب فئة المطوّر	خطة تعرفات تنطبق على جميع المطوّرين في فئة معيّنة وتتوفّر للشراء من قِبل جميع المطوّرين في تلك الفئة
خطة تعرفات المطوّرين	خطة أسعار تنطبق على مطوّر معيّن ولا يمكن شراؤها إلا من قِبل هذا المطوّر
موظّف الدعم الذي تم الإفصاح عنه	في القانون التجاري، هو الشخص المفوَّض بالتصرف نيابةً عن شخص آخر (يُطلَق عليه الموكل) لإنشاء علاقة قانونية مع طرف ثالث. في ما يتعلّق بتحقيق الربح، يمكن إعداد نموذج ضريبي لخطّة أرباح مشترَكة بحيث يعمل مقدّم واجهة برمجة التطبيقات كوكيل إعلام للمطوّر لجمع الأرباح (وربما ضرائب المبيعات) بالنيابة عن المطوّر.
نموذج الضريبة المُعلَن عنه	نموذج ضريبي يعمل فيه مقدّم واجهة برمجة التطبيقات كوكيل مُعلَن عنه للمطوّر.
البيئة	سياق تنفيذ وقت التشغيل لواجهات برمجة التطبيقات يجب نشر واجهة برمجة التطبيقات في بيئة قبل أن تتمكّن من الوصول إليها أثناء التشغيل. يتم تلقائيًا توفير مؤسستَي Apigee في البيئتَين "test" و"prod". تُستخدَم عادةً بيئة "الاختبار" لنشر واجهات برمجة التطبيقات التي تخضع للاختبار. تُستخدَم بيئة "prod" عادةً لنشر واجهات برمجة التطبيقات بهدف استخدامها في مرحلة الإنتاج.
نموذج الضريبة المختلط	نموذج ضريبي يعمل فيه مقدّم واجهة برمجة التطبيقات كوكيل مُعلَن عنه للمطوّر. ومع ذلك، يدفع مقدّم واجهة برمجة التطبيقات ضريبة المبيعات التي يتم تحصيلها من المشتركين إلى سلطات الضرائب المحلية بالنيابة عن المطوّر.
الحدّ الضمني	حدّ (مثل حدّ الرصيد المدفوع مسبقًا للمطوّر) يتمّ ضبطه من خلال تحقيق الربح
تحقيق الربح	عنصر من خدمات المطوّرين في Apigee Edge يقدّم طريقة سهلة الاستخدام ومرنة لتحقيق الربح من منتجات واجهات برمجة التطبيقات.
المبلغ المستخدَم شهريًا	إجمالي استخدام المطوّر خلال شهر معيّن، بما في ذلك رسوم الإعداد + رسوم المعاملات + الرسوم المتكررة
الدفعات الشهرية	الدفعات المتكرّرة التي يدفعها المطوّر استنادًا إلى الخطط التي تم شراؤها يمكن أن تشمل خطط الأسعار رسومًا متكررة يتم تحصيلها من المطوّر كل شهر بغض النظر عن معدّل الاستخدام.
بيان التسوية	مستند مالي يعرض صافي الأرصدة بين الفواتير وكشوف حصة الإيرادات
فتح التعديل	تعديل لم يتم تطبيقه بعد في مستندات الفوترة المنشورة
شهر الفوترة المفتوح	شهر تقويمي كامل لم يتم فيه نشر مستندات الفوترة "النهائية"
مؤسسة	حاوية لجميع العناصر في حسابك على Apigee، بما في ذلك واجهات برمجة التطبيقات ومنتجاتها وحِزمها وتطبيقاتها ومطوّريها يجب أن يكون لديك حساب مستخدم لكل مؤسسة قد تكون عضوًا فيها. (سيمتلك معظم المستخدمين حسابًا في مؤسسة واحدة فقط). عليك تقديم بيانات الاعتماد (اسم المستخدم وكلمة المرور) واسم مؤسستك مع كل طلب واجهة برمجة تطبيقات ترسله.
كتالوج الحِزم	قائمة بحِزم واجهة برمجة التطبيقات يتم إدراج كل حزمة مع منتجات واجهة برمجة التطبيقات وخطط أسعارها.
الرصيد المدفوع مسبقًا	مبلغ مالي متاح للمطوّر الذي يستخدم نظام الدفع المُسبَق لتسديد رسوم حِزم واجهة برمجة التطبيقات مقدمًا
مطوّر الدفع المُسبَق	مطوّر يدفع مسبقًا مقابل استخدام منتج واجهة برمجة تطبيقات. يتم خصم الأموال من رصيد المطوّر المدفوع مسبقًا عند استخدام منتج واجهة برمجة التطبيقات. على المطوّر الاحتفاظ بأحد الرصيد المدفوع مسبقًا بما يكفي لشراء منتج واجهة برمجة التطبيقات. يحدّد مزوّد واجهة برمجة التطبيقات حالة الدفع المُسبَق أو الدفع عند الاستخدام للمطوّرين.
السياسة	خطوة معالجة يتم تنفيذها كوحدة منطقية قابلة لإعادة الاستخدام ضمن تدفق واجهة برمجة التطبيقات تشمل السياسات المعتادة توجيه الطلبات إلى نقطة النهاية المناسبة، وتحويل تنسيق الرسالة، وفرض التحكّم في الوصول، والاتصال بالخدمات البعيدة للحصول على معلومات إضافية، وإخفاء البيانات الحسّاسة من المستخدمين الخارجيين، وفحص محتوى الرسائل بحثًا عن التهديدات المحتملة، وتخزين الردود الشائعة لتحسين الأداء، وما إلى ذلك. قد تتم تنفيذ السياسات بشكل مشروط استنادًا إلى محتوى طلب أو رسالة استجابة أو سياقهما. على سبيل المثال، قد يتم تنفيذ سياسة تحويل لتخصيص تنسيق الردّ إذا تم إرسال رسالة الطلب من هاتف ذكي.
مطوّر تطبيقات الدفع عند الاستخدام	مطوِّر يتم إصدار فاتورة له شهريًا (من خلال فاتورة) مقابل استخدام منتجات واجهات برمجة التطبيقات. يدفع المطوِّر مقابل استخدام منتجات واجهة برمجة التطبيقات استنادًا إلى بنود الدفع التي تحدّدها الخطط المُدرَجة في الفاتورة. يحدِّد مزوّد واجهة برمجة التطبيقات حالة الدفع عند الاستخدام أو الدفع المُسبَق للمطوّرين.
نقاط السعر	نطاق الأسعار المحتمَلة التي يمكن تسويق منتج أو خدمة بها
خطة تعرفات بطاقة الأسعار	خطة تعرفات يتم فيها تحصيل تعرفة ثابتة أو متغيرة من المطوّر مقابل كل معاملة تشمل منتج واجهة برمجة تطبيقات يحقّق الربح
خطة الأسعار	مواصفات الرسوم والرسوم الأخرى وحصة الأرباح مقابل استخدام منتجات واجهات برمجة التطبيقات المقدَّمة في حزمة واجهة برمجة تطبيقات تحقّق الربح
resource path	مسار المورد هو مفهوم RESTful، وهو معرّف موارد منتظم (URI) يحدد مسار الشبكة إلى مورد معيّن.
خطة نسبة حصة الأرباح	خطة تعرفات يتم فيها مشاركة نسبة مئوية من الأرباح المحقَّقة من كل معاملة تتضمّن منتج واجهة برمجة تطبيقات يحقّق الربح مع مطوّر التطبيق الذي يُصدر الطلب.
خطة مشاركة الأرباح وجدول الأسعار	خطة تعرفات يتم فيها مشاركة نسبة مئوية من الأرباح المحقَّقة من كل معاملة تتضمّن منتج واجهة برمجة تطبيقات يحقّق الربح مع مطوّر التطبيق الذي يُصدر الطلب. ويدفع المطوّر أيضًا رسومًا ثابتة أو متغيرة مقابل كل معاملة.
فاتورة الفوترة الذاتية	مستند مالي يتم إنشاؤه بدلاً من بيان مشاركة الأرباح ويوضّح هذا التقرير بالتفصيل المبلغ المستحق للمطوّر، كما يُعدّ فاتورة لمقدّم واجهة برمجة التطبيقات نيابةً عن المطوّر.
خطة الأسعار العادية	خطة تعرفات يمكن لجميع المطوّرين شراؤها
ضريبة	إجمالي الضريبة المطبَّقة على استخدام المطوّر ورسومه.
إضافة رصيد	الإجراء الذي يتّخذه المطوّر الذي يستخدم نظام الدفع المُسبَق لإضافة أموال إلى الرصيد المُسبَق.
سياسة تسجيل المعاملات	آلية تتيح تحقيق الربح من خلال تسجيل مَعلمات المعاملات والعلامات المخصّصة تحتاج ميزة تحقيق الربح إلى هذه المعلومات لتنفيذ معالجة تحقيق الربح، مثل تطبيق خطط الأسعار على طلبات البيانات الواردة من واجهة برمجة التطبيقات وردود هذه الطلبات استنادًا إلى السمات المخصّصة التي يتم تسجيلها في كل معاملة.
وكيل غير معروف	مؤسسة (أو مشغّل) يشارك في العرض الأساسي للتطبيقات، بحيث يُعتبَر أنّه يشتري المحتوى نيابةً عن المطوّر (لأغراض ضريبية فقط). بصفتها وكيلاً غير مُعلَن عنه، يمكن للمؤسسة (أو المشغّل) تحصيل الضرائب المستحقة من المستخدمين النهائيين وإعداد حسابات لها. لا تكون هذه الحالة ذات صلة إلا لأغراض ضريبية، ولا تتأثر الحالة القانونية للمطوّر في سلسلة الإمداد.
نموذج الضريبة غير المُعلَن عنه	نموذج ضريبي يخصم فيه موفِّر واجهة برمجة التطبيقات الضريبة التي يتم تحصيلها من المستخدمين النهائيين ويدفعها إلى الهيئات الضريبية المحلية.
الإصدار	إصدار واجهة برمجة التطبيقات الموجّهة للمطوّرين على سبيل المثال، pivotaltracker.com/services/v3 أو api.enterprise.apigee.com/v1. (يختلف هذا المصطلح عن "المراجعة"، وهي الحزمة المرقّمة التي يتم التحكّم في إصدارها والتي تتضمّن الإعدادات والسياسات المجمّعة في وكيل واجهة برمجة التطبيقات. بعبارة أخرى، تتضمّن واجهات برمجة التطبيقات إصدارات، في حين تتضمّن وكيلات برمجة التطبيقات المراجعات.