المتطلبات الأساسية
حساب تاجر في Rntor مع صلاحيات المالك
الوصول إلى Settings → Developers في لوحة التحكم الخاصة بك
الخطوة 1: الانتقال إلى Developers
- سجّل الدخول إلى لوحة تحكم Rntor الخاصة بك
- انتقل إلى Settings في شريط التنقل الرئيسي
- اختر علامة التبويب Developers

الخطوة 2: إنشاء بيانات اعتماد API
تُستخدم مفاتيح API لمصادقة تكاملك. وبينما لا تزال REST API قادمة قريباً، فإن إنشاء بيانات الاعتماد الآن يهيئك للوصول الفوري عند إطلاقها.- في قسم API Keys، انقر على Generate New Key
- أدخل اسماً وصفياً (مثل “Production Integration” أو “Zapier Connection”)
- راجع النطاقات الافتراضية
- انقر على Generate
- Client ID:
rntor_متبوعاً بـ 24 حرفاً (آمن للتخزين، يُستخدم في الطلبات) - Client Secret:
sk_متبوعاً بـ 40 حرفاً (احتفظ به سراً، يُستخدم للمصادقة)
Example Credentials
الخطوة 3: إعداد نقاط نهاية Webhook
تتيح لك Webhooks استقبال إشعارات في الوقت الفعلي عند وقوع الأحداث في Rntor.- انتقل إلى علامة التبويب Webhooks
- ستُحمَّل بوابة webhooks الخاصة بـ Svix
- انقر على Add Endpoint
- أدخل عنوان URL لنقطة النهاية الخاصة بك (يجب أن يكون HTTPS)
- اختر الأحداث التي تريد الاشتراك فيها
الاختبار محلياً
للتطوير المحلي، استخدم خدمة نفق:Using ngrok
الخطوة 4: تحقق من أول webhook
بمجرد الاشتراك، أطلق حدثاً في Rntor (مثل إنشاء حجز) وتحقق من:- أن نقطة النهاية الخاصة بك تتلقى طلب POST
- أن الحمولة تحتوي على البيانات المتوقعة
- أن التحقق من التوقيع يمر بنجاح (انظر الأمان)
Example: Logging Received Webhooks
الخطوات التالية
أمان Webhook
طبّق التحقق من التوقيع لتأمين نقاط النهاية الخاصة بك
مصادقة API
تعرّف على كيفية مصادقة طلبات API الخاصة بك
حدود المعدل
تخضع جميع طلبات API لحدود معدل لضمان استقرار المنصة:| الحد | القيمة |
|---|---|
| الطلبات لكل دقيقة | 60 |
| حد الدفعة | 10 طلبات |
429 Too Many Requests.