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

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

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

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