دليل واجهة دروج البرمجية

المصادقة

أنشئ مفتاحًا من إعدادات المنشأة/الربط. أرسله في ترويسة API-KEY عبر HTTPS. لا تشارك المفتاح في رابط أو سجل عام، وألغِه إذا انكشف.

المسار الأساسي

تبدأ الموارد من https://durooj.com/2.0/ . مثال قراءة العملاء: GET /2.0/customers . استخدم المفتاح الخاص بالمنشأة المقصودة؛ لا تُستنتج صلاحيات من اسم المنشأة في الواجهة.

النتائج والصفحات

تدعم موارد القوائم معاملات page وper_page، وتعيد معلومات meta عن العدد والصفحة. استخدم Content-Type: application/json للطلبات التي تحمل JSON.

الأخطاء وإعادة المحاولة

راجع رمز HTTP ومحتوى الخطأ. توقف عند فشل المصادقة، واحترم Retry-After عند تجاوز الحد. لا تكرر طلب كتابة بلا معرفة ما إذا كان الطلب السابق قد نجح؛ استخدم Idempotency-Key حيث تدعمه العملية.

التوافق مع الإصدارات السابقة

تظل بعض صيغ المفاتيح والترويسات القديمة مقبولة لحماية التكاملات القائمة. لا تعِد تسمية مفاتيح أو معرّفات محفوظة يدويًا. واجهة الاستخدام والروابط العامة تعمل بهوية دروج.

مثال طلب قراءة

curl "https://durooj.com/2.0/customers?page=1&per_page=20" -H "API-KEY: YOUR_API_KEY" -H "Accept: application/json"

استبدل YOUR_API_KEY بمفتاحك داخل بيئة خادم آمنة فقط؛ المثال لا يحتوي على مفتاح فعلي.