ما فائدة رموز الوصول
رمز الوصول (ويُسمّى أيضًا مفتاح API) يتيح لبرنامجك الخاص أو لمطوّر أو لأداة خارجية قراءة بيانات متجرك عبر واجهة Storeep البرمجية (API). لكل رمز صلاحياته ونطاق بياناته وتاريخ انتهائه، فتعطي كل أداة ما تحتاجه بالضبط وتزيلها في أي وقت دون مشاركة كلمة مرورك.
افتح الإعدادات ← رموز الوصول. يفتح زر عرض الوثائق مرجع API، مع نقاط الوصول (endpoints)، وطريقة إرسال الرمز، وحدود الطلبات. شارك تلك الصفحة مع المطوّر لديك.
تريد ربط مساعد ذكاء اصطناعي مثل Claude أو ChatGPT بدلًا من ذلك؟ هذا لا يستخدم رموز الوصول. راجع ربط مساعد ذكاء اصطناعي.
إنشاء رمز
انقر على إنشاء رمز جديد، واملأ النموذج، وانقر على إنشاء.
- اسم الرمز: تسمية تتعرف بها عليه في قائمتك، مثل "مزامنة المحاسبة". لا يراها غيرك.
- الصلاحيات: حدّد صلاحية واحدة على الأقل:
- قراءة المنتجات: قوائم المنتجات وتفاصيلها ومتغيراتها ومخزونها.
- قراءة الطلبات: سجل الطلبات وتفاصيلها وحالاتها وبنودها.
- قراءة Webhooks: عرض إعدادات الـ Webhooks وسجلات الإرسال.
- إدارة Webhooks: إنشاء اشتراكات الـ Webhooks وتحديثها وحذفها عبر API.
- الوصول إلى البيانات: إلى أي مدى زمني في الماضي يستطيع الرمز القراءة.
- آخر 24 ساعة: البيانات التي أُنشئت في آخر 24 ساعة فقط. الخيار الأكثر أمانًا، ومناسب للمزامنة المباشرة.
- تعيين تاريخ البدء: البيانات التي أُنشئت في تاريخ تختاره في تاريخ بدء الوصول إلى البيانات أو بعده فقط.
- كل الأوقات: كل بياناتك، دون حد زمني.
- انتهاء الصلاحية: لا تنتهي صلاحيته أبداً، أو تعيين تاريخ انتهاء الصلاحية لاختيار تاريخ حتى سنة واحدة للأمام. بعد هذا التاريخ يتوقف الرمز عن العمل من تلقاء نفسه.
انسخ رمزك الآن
بعد النقر على إنشاء، تعرض النافذة رمز الوصول الخاص بك مع زر نسخ. لا يُعرض هذا الرمز إلا مرة واحدة. انسخه واحفظه في مكان آمن، مثل مدير كلمات المرور. لا يستطيع Storeep عرضه مرة أخرى. إذا فقدته، فاحذف الرمز وأنشئ رمزًا جديدًا.
تعامل معه ككلمة مرور. لا تضعه أبدًا في كود موقع، أو مستودعات عامة، أو لقطات شاشة، أو رسائل دردشة.
قائمة الرموز
- الاسم، مع تاريخ إنشائه.
- الصلاحيات: مثل قراءة المنتجات أو قراءة الطلبات.
- الوصول إلى البيانات: آخر 24 ساعة، أو جميع البيانات، أو من تاريخ معين.
- انتهاء الصلاحية: تاريخ، أو أبداً.
- آخر استخدام: آخر مرة استخدمت فيها أداة هذا الرمز، أو أبداً.
هناك حد أقصى لعدد الرموز في كل متجر. عند بلوغه، يختفي زر إنشاء رمز جديد حتى تحذف رمزًا.
تعديل رمز
انقر على رمز لتغيير اسمه أو صلاحياته أو الوصول إلى البيانات أو تاريخ انتهائه. تبقى قيمة الرمز كما هي، فتستمر الأداة التي تستخدمه في العمل بالقواعد الجديدة.
حذف رمز
حدّد رمزًا أو أكثر واختر حذف الرموز، أو استخدم زر سلة المهملات في الصف. يتوقف الرمز عن العمل فورًا، وتحصل أي أداة تستخدمه على خطأ.
نصائح
- أعطِ كل أداة رمزها الخاص، لتتمكن من إزالة أحدها دون تعطيل الأخرى.
- اختر أصغر نطاق بيانات يفي بالغرض.
- حدّد تاريخ انتهاء للمستقلين وللمهام المؤقتة.
- الرمز الذي يعرض أبداً في آخر استخدام لفترة طويلة غالبًا لا حاجة إليه. احذفه.
- لكي يرسل Storeep أحداث الطلبات إلى خادمك بدلًا من أن يطلبها خادمك، استخدم الـ Webhooks.