تخطَّ إلى المحتوى
دُرج

البدء السريع

تتيح لك واجهة برمجة تطبيقات التكامل من دُرج مزامنة بيانات متجرك مع أنظمة خارجية مثل Odoo ERP.

عنوان API الأساسي

https://api.durj.ly/api/v1/

البدء السريع

1. إنشاء مفتاح API

اذهب إلى لوحة التحكم ← التكاملات ← تبويب مفاتيح API وأنشئ مفتاحاً جديداً.

2. أول طلب

Terminal window
curl -H "Authorization: Bearer tjr_your_token_here" \
  https://api.durj.ly/api/v1/products?limit=5

3. الاستجابة

{
  "data": [
    {
      "id": "abc123",
      "name": "قهوة عربية فاخرة",
      "price": 25.00,
      "stock": 150,
      "last_modified": "2026-04-20T10:30:00Z"
    }
  ],
  "pagination": {
    "next_cursor": "2026-04-20T10:30:00Z",
    "has_more": true,
    "limit": 5
  }
}

المفاهيم الأساسية

الترقيم بالمؤشر

جميع نقاط النهاية تستخدم ترقيماً بالمؤشر عبر last_modified. مرر cursor من الاستجابة السابقة للحصول على الصفحة التالية.

حدود الاستخدام

  • النقاط العادية: 60 طلب/دقيقة لكل مفتاح
  • نقاط التصدير: 10 طلبات/دقيقة لكل مفتاح

الكيانات المتاحة

الكيانالنقطةالوصف
المنتجات/v1/productsالكتالوج مع المتغيرات والصور
الطلبات/v1/ordersطلبات البيع مع البنود
العملاء/v1/customersسجلات العملاء
المخزون/v1/inventoryمستويات المخزون والحركات