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

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

هناك عدة مفاهيم هي أفكار شائعة تحمل معنى فريدًا في Apigee.

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