واجهة المتجر البرمجية: قراءة قائمة الطلبات بالحالة والتاريخ
مرجع عنوان قائمة الطلبات في واجهة متجر عربي بوت: التصفية بالحالة والتاريخ، الصفحات، شكل الطلب، وحالات الرفض.
الإجابة المختصرة
بطلب 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.
حالات الرفض
كل رفض يعود 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. ولكل متجر حتى خمسة مفاتيح. والمفتاح لا يرى إلا متجره، ويلزم أن تكون باقة المتجر سارية.
كل عناوين واجهة المتجر · كل الواجهات للمطورين
الأسئلة الشائعة
كيف أسحب الطلبات الجديدة فقط كل مرة؟
أرسل في since وقت آخر سحب ناجح، أو استعمل إشعارات المتجر فتصلك الطلبات لحظة إنشائها دون سؤال متكرر.
كم طلبًا يعود في المرة؟
خمسون في الصفحة، الأحدث أولًا. والحقل has_more يقول هل توجد صفحة تالية.
اقرأ بعدها
جرّب الوكيل قبل أن تدفع شيئًا
الوكيل الذي يرد على عملائك هو نفسه الذي يرد عليك الآن: اسأله من زر الدردشة هنا أو على واتساب. وحسابك مجاني بلا بطاقة ائتمان، والتجربة المجانية على رقمك أو صفحتك تُفعَّل بعد التواصل مع الإدارة على واتساب خدمة العملاء.