التوثيقتطبيقات OAuth

تطبيقات OAuth

إنشاء تطبيقات OAuth آمنة لتكامل خدمات الطرف الثالث مع Syncaty. يوفر OAuth وصولاً مفوضاً بدون مشاركة بيانات الاعتماد.

نظرة عامة

تتيح تطبيقات OAuth للخدمات الخارجية (مثل n8n) الوصول لبيانات Syncaty نيابة عنك. كل تطبيق يحصل على بيانات اعتماد فريدة ويمكن منحه صلاحيات محددة (نطاقات).

وصول آمن

يمكن إلغاء رموز OAuth بدون تغيير كلمة المرور. كل تكامل له بيانات اعتماد منفصلة.

صلاحيات محددة

امنح فقط الصلاحيات التي يحتاجها كل تكامل. حدد الوصول لأنواع بيانات محددة.

إنشاء تطبيق OAuth

  1. اذهب إلى الإعدادات ← تطبيقات OAuth في لوحة تحكم Syncaty
  2. انقر "إنشاء تطبيق جديد"
  3. أدخل اسماً وصفياً للتطبيق
  4. أدخل عنوان إعادة التوجيه (حيث يعود المستخدمون بعد التصريح)
  5. انقر "إنشاء"
  6. انسخ واحفظ معرف العميل والسر بأمان

مهم

يُعرض سر العميل مرة واحدة فقط عند الإنشاء. احفظه بأمان. إذا فُقد، ستحتاج لإعادة إنشائه.

تدفق OAuth

يستخدم Syncaty تدفق رمز التفويض القياسي OAuth 2.0:

1

طلب التفويض

وجه المستخدمين لنقطة نهاية التفويض مع client_id والنطاقات.

2

تفويض المستخدم

يسجل المستخدم الدخول ويوافق على الصلاحيات المطلوبة.

3

رمز التفويض

يُعاد توجيه المستخدم مع رمز التفويض.

4

تبادل الرمز

استبدل الرمز برموز الوصول والتحديث.

النطاقات المتاحة

النطاقالوصول
stores:readقراءة معلومات وإعدادات المتجر
customers:readقراءة ملفات العملاء والتحليلات
orders:readقراءة بيانات وسجل الطلبات
products:readقراءة كتالوج المنتجات والفئات
segments:readقراءة شرائح العملاء والقواعد
segments:writeإنشاء وتعديل الشرائح

أفضل الممارسات

اطلب الحد الأدنى من النطاقات

اطلب فقط الصلاحيات التي يحتاجها تكاملك فعلاً.

احفظ الأسرار بأمان

لا تلتزم أبداً بأسرار العميل في التحكم بالإصدار. استخدم متغيرات البيئة.

استخدم HTTPS

استخدم دائماً HTTPS لعناوين إعادة التوجيه في الإنتاج.

نفذ تحديث الرمز

لا تعتمد على الرموز طويلة الأمد. نفذ التحديث التلقائي للرمز.