مفاتيح API: ربط تطبيق بمتجرك
يتيح مفتاح API لتطبيق أو خدمة (روبوت محادثة يستقبل الطلبات، أو نظام المستودع الخاص بك، أو أداة أتمتة) قراءة بيانات متجرك وتعديلها عبر واجهة Ordexs البرمجية. تجد المفاتيح في الإعدادات ← المطوّرون ← مفاتيح API.
من يمكنه إدارتها. مالك المتجر والمسؤولون. أما أعضاء الفريق الآخرون الذين لديهم صلاحية الوصول إلى الإعدادات فيمكنهم رؤية القائمة، لكن لا يمكنهم إنشاء المفاتيح أو إلغاؤها.
الباقات. تتوفر مفاتيح API في باقات Starter وGrowth وScale: 3 و10 و25 مفتاحًا نشطًا. في باقة Try تُوقَف المفاتيح الموجودة مؤقتًا (ولا تُحذف)، وتعود إلى العمل فور ترقية المتجر.
إنشاء مفتاح. اضغط إنشاء مفتاح، وأعطه اسمًا تتعرّف عليه، واختر فعلي أو تجريبي، ثم حدّد صلاحياته. تتوفر اختصارات: قراءة فقط وتطبيق طلبات ووصول كامل؛ ويمكنك بدلًا من ذلك تحديد الصلاحيات واحدة واحدة (عرض المنتجات والمخزون، تعديل الطلبات، عرض العملاء، عرض الشحنات، الإرسال إلى شركة التوصيل، إسناد الطلبات، عرض تفاصيل المخزون، إدارة المخزون، عرض العروض والتخفيضات أو إدارتها، عرض التحصيل والدفعات، تسجيل دفعات شركات التوصيل، إدارة webhooks، وغير ذلك). تتيح «إدارة المخزون» للتطبيق إضافة مخزون أو سحبه مع ذكر السبب، وتسجيل الكميات الواردة، وإجراء عمليات الجرد؛ وتظهر تغييراته في سجلّ المخزون باسم المفتاح. أما «عرض أسعار التكلفة» فتبقى معطّلة إلا إذا فعّلتها.
الإرسال إلى شركة التوصيل. يستطيع المفتاح الذي يملك هذه الصلاحية إرسال طلباتك إلى شركة التوصيل، وإلغاء الطرود التي لم تستلمها الشركة بعد، تمامًا مثل زر إرسال إلى شركة التوصيل: نفس اختيار شركة التوصيل (التي اختارها الزبون عند الطلب، وإلا فقواعد التوجيه لديك، وإلا فشركتك الافتراضية)، ونفس عمليات التحقق. كل إرسال من مفتاح فعلي هو طرد حقيقي لدى شركة التوصيل. ولا يمكن إرسال الطلبات التي لا يزال عنوانها بانتظار التحقق. أما المفتاح التجريبي فلا يصل أبدًا إلى شركة التوصيل: طروده محاكاة فقط.
العروض والتخفيضات. تتيح «إدارة العروض والتخفيضات» للتطبيق إنشاء الحزم وعروض الكميات والبيع المتقاطع وأكواد الخصم وتعديلها وإيقافها مؤقتًا وحذفها، مثل صفحتي العروض والخصومات، وبنفس الحدود (30 عرضًا و50 خصمًا). أما «عرض العروض والتخفيضات» فتقتصر على قراءتها وقراءة نتائجها، والتحقق مما إذا كان كود ما يعمل.
تعديل الطلبات المُرسلة مسبقًا. يستطيع التطبيق الذي يملك صلاحية تعديل الطلبات أن يصحّح أيضًا طلبًا أصبح طرده لدى شركة التوصيل، كما يحدث عند حفظ بطاقة الطلب: يُرسَل التعديل أولًا إلى شركة التوصيل، ولا يُحفظ إلا إذا قبلته، وذلك للبيانات التي تسمح تلك الشركة بتغييرها، وإلى أن يتم تأكيد الطرد أو استلامه.
المعالجة الجماعية. يستطيع التطبيق إرسال آلاف الطلبات أو تعديلات المنتجات أو تعديلات المخزون دفعة واحدة (حتى 10,000 سطر في كل عملية). يعالجها Ordexs في الخلفية، كل سطر كما لو أُرسل وحده تمامًا، ويُخبر التطبيق بالأسطر التي فشلت وسبب فشلها. يُشغّل المتجر 3 عمليات في الوقت نفسه. ويستطيع التطبيق الذي يملك صلاحية قراءة الطلبات تنزيلها كلها في ملف تصدير واحد.
بكسلات التسويق. تتيح «إدارة بكسلات التسويق» للتطبيق إضافة بكسلات Meta وTikTok وGoogle وغيرها أو تعديلها أو حذفها، مثل التكاملات ← البكسلات. لا يُشارَك رمز Conversions API مع التطبيقات أبدًا: أنت من يضيفه في لوحة التحكم.
محتوى المتجر. تتيح «إدارة محتوى المتجر» للتطبيق تعديل بيانات متجرك (الاسم، ووسائل التواصل، والعنوان، ولغة المتجر، والمنطقة الزمنية، وبادئة أرقام الطلبات)، وسياساتك، وصفحات المحتوى، وحقول وأزرار نموذج الطلب. ويمكن نشر صفحات الهبوط أو إعادة تسميتها أو نسخها أو حذفها، لكن تصميمها يبقى في منشئ الصفحات.
التحليلات. تتيح «عرض الإحصائيات» للتطبيق قراءة الأرقام نفسها التي تعرضها نظرة عامة (الطلبات، والإيرادات، والزيارات، وأموالك، وشركات التوصيل، والأكثر مبيعًا، والمناطق)، وتحليلات العملاء، وأداء الفريق. ولا يمكنه تغيير أي شيء.
إعداد التوصيل. تتيح «إدارة إعداد التوصيل» للتطبيق تغيير أسعار التوصيل لكل ولاية، واستراتيجية التسعير (أسعارك الخاصة، أو يختار الزبون شركة التوصيل، أو أرخص شركة توصيل)، وتفعيل التوصيل إلى المنزل ومكتب التوصيل (stop desk) أو إيقافهما، وشركة التوصيل الافتراضية وقواعد التوجيه، مثل صفحة التوصيل. أما ربط حساب شركة توصيل (مفاتيحه) فيتم من لوحة التحكم فقط.
صور المنتجات. يستطيع المفتاح الذي يملك صلاحية تعديل المنتجات إضافة صور للمنتجات أيضًا: من عنوان ويب أو من ملف يرفعه التطبيق. يُنشئ Ordexs المقاسات نفسها التي تُنشئها لوحة التحكم، ويضع الملف في مكتبة الوسائط، حيث يُحتسب من مساحة التخزين مثل أي ملف مرفوع. يمكن للتطبيق إضافة 500 صورة يوميًا كحدّ أقصى لكل متجر، ويحتوي المنتج على 50 صورة كحدّ أقصى.
المرتجعات والأموال. مع «إدارة المخزون» يستطيع التطبيق تحديد الطرود المرتجعة على أنها وصلت واستلامها (إعادتها إلى المخزون أو شطبها مع ذكر السبب)، مثل نافذة المرتجعات؛ وتُبلَّغ شركات التوصيل من عائلة Ecotrack بعودة الطرد، كما يحدث من لوحة التحكم. تقرأ «عرض التحصيل والدفعات» ما تدين به كل شركة توصيل عن الطلبات المُسلَّمة ودفعاتها؛ وتسجّل «تسجيل دفعات شركات التوصيل» المبالغ التي تسلّمها شركة التوصيل (وتحذف دفعة ما، فتعود طلباتها إلى انتظار الدفع)، مثل أموالك في نظرة عامة.
يُعرض المفتاح مرة واحدة. بعد إنشائه، يعرض Ordexs المفتاح كاملًا مرة واحدة فقط. انسخه إلى تطبيقك فورًا. لا يحتفظ Ordexs إلا ببصمة له، لذلك لا يمكنه عرضه مجددًا. إذا ضاع منك، أنشئ مفتاحًا جديدًا وألغِ القديم.
المفاتيح الفعلية والتجريبية. يعمل المفتاح الفعلي على طلباتك ومنتجاتك وعملائك الحقيقيين. أما المفتاح التجريبي فيعمل على متجر تجريبي منفصل، حتى يمكن تجربة التطبيق بأمان؛ راجع مقال وضع الاختبار.
الإلغاء. اضغط زر الإلغاء على المفتاح ثم أكّد. تتوقف التطبيقات التي تستخدمه عن العمل خلال 30 ثانية تقريبًا. لا يمكن التراجع عن الإلغاء.
ما تعرضه القائمة. اسم كل مفتاح، وهل هو فعلي أم تجريبي، وعدد صلاحياته، ومتى استُخدم آخر مرة، ومن أنشأه. تظهر التغييرات التي يجريها التطبيق على الطلبات على أنها من مفتاح API «<اسمه>».
ما سرعة التطبيق. يتوقف عدد الطلبات في الدقيقة على الباقة: 120 في Starter، و300 في Growth، و900 في Scale. وتحصل المفاتيح التجريبية على 60 (و120 في Scale).
يجد المطوّرون كل ما يحتاجونه على ordexs.com/docs، والرابط موجود أعلى صفحة المطوّرون.