الغرض من رموز الوصول
تتيح رموز الوصول للتطبيقات الخارجية (نصوصك البرمجية أو التكاملات أو أدوات التحليل أو معالجات خطافات الويب) قراءة البيانات من متجرك عبر Storeep API. كل رمز له نطاق صلاحيات محدود وتاريخ انتهاء صلاحية اختياري. الرموز أكثر أمانًا من مشاركة بيانات اعتماد حسابك لأنها تُقيَّد بما يحتاجه التكامل فعلًا ويمكن إلغاؤها بشكل مستقل في أي وقت.
لإدارة الرموز، انتقل إلى الإعدادات → رموز الوصول. يربط زر عرض الوثائق في اللوحة بمرجع API.
حدود الرموز
- الحد الأقصى 40 رمز وصول لكل متجر. يُخفى زر إنشاء رمز جديد عند بلوغ هذا الحد.
- تُدرج الرموز من الأحدث إلى الأقدم، بحد 20 لكل صفحة.
إنشاء رمز
انقر إنشاء رمز جديد، أكمل النموذج، وانقر إنشاء.
اسم الرمز
- مطلوب.
- الحد الأقصى 50 حرفًا.
- يُستخدم للتعريف فقط في قائمة الرموز. لا يُرسل أبدًا إلى أطراف خارجية.
الصلاحيات
اختر نطاق صلاحية واحد على الأقل من النطاقات الأربعة المتاحة. كل نطاق مستقل:
- قراءة المنتجات: الوصول إلى قوائم المنتجات والتفاصيل والمتغيرات وبيانات المخزون.
- قراءة الطلبات: الوصول إلى سجل الطلبات والتفاصيل والحالات وبنود الطلب.
- قراءة خطافات الويب: عرض تهيئات خطافات الويب وسجلات التسليم.
- إدارة خطافات الويب: إنشاء اشتراكات خطافات الويب وتحديثها وحذفها.
يجب اختيار نطاق واحد على الأقل. أي نطاق غير محدد لا يمكن لذلك الرمز الوصول إليه حتى لو كانت نقطة نهاية API موجودة.
وصول البيانات
يتحكم هذا الإعداد في المدة الزمنية الماضية التي يستطيع الرمز الوصول إليها من بياناتك. اختر الخيار الأكثر تقييدًا الذي يلائم احتياجات تكاملك.
- آخر 24 ساعة (الافتراضي): يستطيع الرمز الوصول فقط إلى بيانات 24 ساعة الأخيرة. موصى به للتكاملات الفورية مثل تغذية الطلبات المباشرة.
- تحديد تاريخ البدء: يستطيع الرمز الوصول إلى البيانات من تاريخ تقويمي محدد إلى الأمام. عند اختياره، يظهر محدد تاريخ تاريخ بدء وصول البيانات لاختيار التاريخ.
- كل الأوقات: بلا قيد زمني. يستطيع الرمز الوصول إلى جميع البيانات التاريخية. استخدمه فقط عندما يحتاج التكامل فعلًا إلى السجل الكامل.
انتهاء الصلاحية
- لا تنتهي صلاحيته (الافتراضي): الرمز صالح إلى أجل غير مسمى حتى يُحذف يدويًا.
- تحديد تاريخ انتهاء الصلاحية: عند اختياره، يظهر محدد تاريخ تاريخ انتهاء الصلاحية. يجب أن يكون التاريخ على الأقل يومًا واحدًا في المستقبل وأقصاه سنة من اليوم. بعد تاريخ انتهاء الصلاحية يتوقف الرمز عن العمل تلقائيًا.
قيمة الرمز
بعد النقر على إنشاء، تُعرض قيمة الرمز مرة واحدة في رسالة النجاح. انسخها واحفظها بأمان. لا يستطيع Storeep إظهارها مرة أخرى. إذا فقدتها، احذف الرمز وأنشئ واحدًا جديدًا.
تعديل رمز
انقر صف الرمز لتعديل اسمه وصلاحياته ووضع وصول البيانات وتاريخ انتهاء الصلاحية. لا يمكنك استرداد قيمة الرمز أو تغييرها. التعديل يغير الإعدادات المرتبطة بالرمز الموجود فقط.
أعمدة قائمة الرموز
- الاسم: التسمية التي أعطيتها للرمز مع تاريخ إنشائه في الأسفل.
- الصلاحيات: قائمة بالنطاقات الممنوحة.
- وصول البيانات: يعرض آخر 24 ساعة أو جميع البيانات أو من [التاريخ] حسب الوضع.
- انتهاء الصلاحية: تاريخ الانتهاء أو لا ينتهي.
- آخر استخدام: تاريخ ووقت آخر استخدام للرمز لإجراء طلب API مُصادق عليه، أو لم يُستخدم.
حذف رمز
اختر رمزًا أو أكثر وانقر حذف الرموز. تُبطَّل الرموز المحذوفة فورًا. أي تكامل يستخدم رمزًا محذوفًا سيبدأ في تلقي أخطاء المصادقة.
نصائح أمنية
- امنح الحد الأدنى من الصلاحيات المطلوبة لكل تكامل.
- استخدم وصول بيانات آخر 24 ساعة لخطافات الويب والتغذية الفورية؛ واستخدم تحديد تاريخ البدء لمهام المزامنة المجدولة.
- حدد تاريخ انتهاء صلاحية للرموز الممنوحة للمتعاقدين المؤقتين أو التكاملات لمرة واحدة.
- راقب عمود آخر استخدام. الرمز الذي لم يُستخدم قط أو لم يُستخدم مؤخرًا قد ينتمي إلى تكامل غير نشط ويمكن حذفه بأمان.