واجهة المتجر

واجهة المتجر البرمجية: قراءة قائمة الطلبات بالحالة والتاريخ

مرجع عنوان قائمة الطلبات في واجهة متجر عربي بوت: التصفية بالحالة والتاريخ، الصفحات، شكل الطلب، وحالات الرفض.

4 دقائق قراءة آخر تحديث 16 نوفمبر 2026 فريق عربي بوت
فريق عربي بوتشريك Meta الرسمي · نكتب من بيانات منصتنا
في هذه الصفحة 7
  1. العنوان والتوثيق
  2. الحقول
  3. مثال طلب
  4. الرد
  5. حالات الرفض
  6. الحدود
  7. الأسئلة الشائعة

الإجابة المختصرة

بطلب GET إلى العنوان orders في واجهة المتجر. يعود الرد بالطلبات، الأحدث أولًا، خمسين في الصفحة، ويمكنك تصفيتها بالحالة وبتاريخ بداية. كل طلب يعود ببياناته كاملة: العميل والعنوان والأصناف والمبالغ والشحن. والحقل has_more يقول هل توجد صفحة تالية.

يُسأل عنها أيضًا: «اسحب طلبات المتجر على شيت او سيستم» · «api الطلبات»

العنوان والتوثيق

GET https://app.arabybot.com/store_api/v1/orders

أرسل مفتاح المتجر في الترويسة Authorization: Bearer abst_… أو X-Api-Key. تنشئ المفتاح من إعدادات المتجر، ويُعرض مرة واحدة، ولا يرى إلا متجره. هذا العنوان يقبل مفتاح القراءة ومفتاح الكتابة.

الحقول

  • status (اختياري) حالة واحدة: new أو confirmed أو preparing أو shipped أو delivered أو returned أو cancelled.
  • since (اختياري) تاريخ بداية بصيغة سنة ثم شهر ثم يوم كما في المثال؛ تعود الطلبات المنشأة منه فصاعدًا.
  • page (اختياري) رقم الصفحة، يبدأ من 1. في الصفحة 50 طلبًا.

مثال طلب

cURL

curl "https://app.arabybot.com/store_api/v1/orders?status=new&since=2026-11-01&page=1" \
  -H "Authorization: Bearer abst_YOUR_STORE_KEY"

PHP

$ch = curl_init('https://app.arabybot.com/store_api/v1/orders?status=new&since=2026-11-01&page=1');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer abst_YOUR_STORE_KEY'],
]);
$answer = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Python

import requests

r = requests.get(
    'https://app.arabybot.com/store_api/v1/orders?status=new&since=2026-11-01&page=1',
    headers={
        "Authorization": "Bearer abst_YOUR_STORE_KEY",
    },
    timeout=30,
)
print(r.status_code, r.json())

Node.js

// Node.js 18+
const r = await fetch('https://app.arabybot.com/store_api/v1/orders?status=new&since=2026-11-01&page=1', {
  headers: {"Authorization": "Bearer abst_YOUR_STORE_KEY"},
});
console.log(r.status, await r.json());

الرد

200
{ "ok": true, "orders": [ { "id": 9041, "number": "1042", "status": "new", "total": 530.0, "…": "…" } ],
  "page": 1, "has_more": false }
  • كل عنصر في orders طلب كامل بالشكل نفسه الذي يعود من عنوان الطلب الواحد.
  • has_more تكون true حين توجد صفحة تالية؛ اطلبها بزيادة page.
واجهة عربي بوت كما تعمل اليوم، مقروءة من النظام نفسهقياس 16 نوفمبر 2026

حالات الرفض

كل رفض يعود JSON فيه "ok": false والكود في error:

  • 422 bad_status: قيمة status ليست من الحالات السبع.
  • 422 bad_since: قيمة since ليست تاريخًا مفهومًا.
  • 401 unauthorized: المفتاح مفقود أو خاطئ أو أُلغي.
  • 402 store_plan_closed: باقة المتجر انتهت؛ جدّدها.
  • 429: تجاوزت 120 طلبًا في الدقيقة.
  • 500 server_error: خطأ عندنا؛ أعد المحاولة.

الحدود

120 طلبًا في الدقيقة من العنوان الواحد؛ تجاوزها يعيد الحالة 429. ولكل متجر حتى خمسة مفاتيح. والمفتاح لا يرى إلا متجره، ويلزم أن تكون باقة المتجر سارية.

كل عناوين واجهة المتجر · كل الواجهات للمطورين

الأسئلة الشائعة

1

كيف أسحب الطلبات الجديدة فقط كل مرة؟

أرسل في since وقت آخر سحب ناجح، أو استعمل إشعارات المتجر فتصلك الطلبات لحظة إنشائها دون سؤال متكرر.

2

كم طلبًا يعود في المرة؟

خمسون في الصفحة، الأحدث أولًا. والحقل has_more يقول هل توجد صفحة تالية.

فريق عربي بوتشريك Meta الرسمي للأعمال في الشرق الأوسط 264 دليلًا أرقام من منصتنا كل الأدلة

كيف نكتب هذه الأدلة الأرقام من منصتنا وفواتير ميتا الفعلية ومؤرّخة بعيّنتها، والوصف لما يعمل اليوم لا لما نعد به، ونذكر ما لا نفعله ومتى يكون غيرنا الخيار الأفضل. راجعه فريق عربي بوت في 16 نوفمبر 2026.

شارك الدليل

جرّب الوكيل قبل أن تدفع شيئًا

الوكيل الذي يرد على عملائك هو نفسه الذي يرد عليك الآن: اسأله من زر الدردشة هنا أو على واتساب. وحسابك مجاني بلا بطاقة ائتمان، والتجربة المجانية على رقمك أو صفحتك تُفعَّل بعد التواصل مع الإدارة على واتساب خدمة العملاء.

وتديره كله من موبايلككل ما في هذه الصفحة تديره من تطبيق عربي بوت على جوالك — الردود والطلبات والحملات وتقارير الذكاء الاصطناعي. لا لوحة تحكم على الويب فحسب.