واجهة برمجة المتجر (Storefront API) — اعرض كتالوجك على موقع أو تطبيق آخر
تتيح واجهة برمجة المتجر (Storefront API) للمطوّر عرض كتالوج متجرك على موقع أو تطبيق يبنيه بنفسه (متجر «headless»)، بينما تواصل أنت إدارة كل شيء في Ordexs. وهي تقرأ ما يستطيع أي متسوّق رؤيته في متجرك أصلًا: المنتجات والأسعار والمجموعات والفئات والصفحات والسياسات والتقييمات والعروض وأسعار التوصيل، ويمكنها حساب سعر سلّة. وهي لا تغيّر أي شيء أبداً، ولا تعرض أبدًا أسعار التكلفة أو الرموز الشريطية أو كميات المخزون أو العملاء أو الطلبات. أما الطلبات من مثل هذا الموقع فتُقدَّم بمفتاح API (راجع القسم الخاص بمفاتيح API).
أين. الإعدادات ← المطوّرون ← واجهة برمجة المتجر (Storefront API). وهي متاحة في كل الباقات، بما فيها Try. يعرض القسم عنوان API الخاص بمتجرك، مع زر نسخ، لتسلّمه لمطوّرك.
الرموز. يحتاج موقع المطوّر إلى رمز متجر (يبدأ بـ ordx_sf_). اضغط رمز جديد، وامنحه اسمًا تتعرّف عليه (مثل الموقع المخصّص له) واختر أين يمكن استخدامه:
- مواقع محددة — اكتب عناوين المواقع، عنوانًا في كل سطر (مثل
https://shop.example.com)، حتى 10 عناوين. تُرفض المتصفحات على أي موقع آخر. اترك القائمة فارغة لاستخدام الرمز من الخوادم وتطبيقات الهاتف فقط (ويُعرض بعبارة «الخوادم والتطبيقات فقط»). - أي موقع — يمكن لأي موقع استخدامه، ويُحتسب ذلك ضمن حدودك.
يمكن أن يكون للمتجر 10 رموز نشطة. ينشئها مالك المتجر والمسؤولون ويعيدون تسميتها ويغيّرونها ويلغونها؛ ويستطيع أعضاء الفريق الآخرون الذين يمكنهم فتح الإعدادات رؤيتها.
رمز المتجر ليس سرًّا. فهو موجود في شيفرة الموقع حيث يمكن لأي أحد قراءته، ولا يفتح إلا ما يعرضه متجرك علنًا أصلًا. لهذا يبقى الرمز كاملًا ظاهرًا في القائمة ويمكن نسخه مجددًا في أي وقت، بخلاف مفتاح API. استخدم مواقع محددة حتى لا يستعيره موقع آخر.
الإلغاء. اضغط زر الإلغاء وأكّد. تتوقف المواقع التي تستخدم الرمز عن العمل خلال دقيقة تقريبًا. لا يمكن التراجع عن الإلغاء؛ أنشئ رمزًا جديدًا إذا احتجت إليه مرة أخرى. عرض الرموز الملغاة يعرض الرموز القديمة.
ما تعرضه القائمة. اسم كل رمز، والرمز نفسه، والمواقع المسموح لها باستخدامه، ووقت آخر استخدام له، وعدد الطلبات التي خدمها خلال آخر 24 ساعة.
الحدود. يعالج كل رمز حتى 3,000 طلب في الدقيقة، وكل زائر حتى 180. تُخزَّن الإجابات مؤقتًا وتتجدّد خلال ثوانٍ من أي تغيير تجريه في لوحة التحكم، فلا يُبطئ موقعٌ مزدحم متجرك.
متجرك أنت لا يحتاج إلى رمز. متجرك على Ordexs، والسكربتات في متجر أُنشئ بمنشئ المتاجر بالذكاء الاصطناعي، تقرأ البيانات نفسها على عنوان متجرك دون رمز.
يجد المطوّرون الدليل الكامل، مع أمثلة، على ordexs.com/docs تحت Storefront API.