تصميم واجهة برمجة تطبيقات التاجر

صمّمنا Merchant API ليكون مألوفًا لمطوّري Content API for Shopping، ولكنّه أبسط وأكثر مرونة. في ما يلي بعض المعلومات التفصيلية حول تصميم Merchant API.

واجهات برمجة التطبيقات الفرعية

‫Merchant API هي مجموعة من واجهات برمجة التطبيقات الفرعية. وتشمل واجهات برمجة التطبيقات الفرعية مجموعات من الخدمات والموارد ذات الصلة. يعني هذا التصميم أنّه يمكنك اختيار استخدام واجهات برمجة التطبيقات الفرعية اللازمة لعملية الدمج الفريدة فقط.

تشمل Merchant API واجهات برمجة التطبيقات الفرعية التالية:

النقل

آلية النقل التلقائية في Merchant API هي gRPC. يمكنك أيضًا استخدام REST.

يُرجى الاطّلاع على دليل البدء السريع لـ مزيد من المعلومات.

عمليات التعداد

قد تعرض حقول التعداد في Merchant API قيمًا جديدة في المستقبل. يجب أن يكون الرمز البرمجي منظّمًا بطريقة تتيح له التعامل مع القيم غير المعروفة بسلاسة. عليك مراقبة ظهور قيم التعداد غير المعروفة والتدخّل للحفاظ على تحديث الرمز البرمجي.

تحديد الإصدار

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

إنّ الإصدارات التي تنتهي بـ "beta" عرضة للتغيير أو الإزالة.