الانتقال إلى المحتوى الرئيسي
يقوم موجز الطلب بإرجاع الطلبات الأخيرة لمساحة العمل الرئيسية API. استخدمه لعمليات التصدير المجدولة ومزامنة التقارير خفيفة الوزن وعمليات التكامل المحاسبية.

طلب SDK

const feed = await plato.v1.orders.externalOrderFeed.query({
  apiKey: process.env.PLATO_API_KEY!,
  date: "2026-06-17",
  endDate: "2026-06-19",
});

طلب الراحة

GET /api/v1/orders/external-feed
``````bash
curl "https://api.plato.ae/api/v1/orders/external-feed?apiKey=$PLATO_API_KEY&date=2026-06-17"

معلمات الاستعلام

المعلمةيكتبملحوظات
apiKeyخيطمطلوب لطريق REST.
dateخيطتاريخ البدء الاختياري. يستخدم المنطقة الزمنية لمساحة العمل.
endDateخيطتاريخ الانتهاء الاختياري. لا يمكن أن تتجاوز النطاقات الزمنية 5 أيام.

الأذونات

يحتاج الدور الرئيسي API إلى:
restaurant:order:read

إجابة

{
  "count": 2,
  "workspaceId": "workspace_123",
  "data": [
    {
      "id": "order_123",
      "referenceNumber": 1042,
      "status": "COMPLETED",
      "subTotal": 120,
      "vatAmount": 6,
      "promoCodeDiscount": 0,
      "discount": 0,
      "totalPriceWithoutDiscount": 126,
      "totalWithoutCharges": 126,
      "totalPrice": 126,
      "chargesDiscountable": [],
      "chargesNonDiscountable": [],
      "payments": [
        {
          "id": "payment_123",
          "type": "SALE",
          "method": "CARD",
          "totalAmount": 126,
          "currency": "AED",
          "status": "PAID",
          "refundMetadata": null
        }
      ],
      "createdAt": "2026-06-17T08:20:00.000Z"
    }
  ]
}

حدود

  • تعرض الخلاصة ما يصل إلى 50 طلبًا لكل طلب.
  • لا يمكن أن تتجاوز النطاقات الزمنية 5 أيام.
  • مسار REST محدود السعر. إذا تلقيت 429، فانتظر قبل إعادة المحاولة.

نمط مزامنة جيد

  1. قم بتشغيل الخلاصة وفقًا لجدول زمني.
  2. قم بتخزين آخر نطاق زمني ناجح في نظامك.
  3. اسحب نطاقًا زمنيًا صغيرًا.
  4. رفع الطلبات بواسطة id.
  5. احتفظ بمعرفات الدفع للتسوية.
استخدم المنطقة الزمنية لمساحة العمل عند اختيار نوافذ التاريخ.