حالة الطلب
يعيد الحالة الحالية لطلب واحد أو ما يصل إلى 100 طلب. يمكن أن تقلل webhooks الاستعلام المتكرر، لكنها تُسلّم بأفضل جهد مع إعادة المحاولة؛ وفّق الحالة المهمة باستخدام إجراء status هذا.
https://notpanel.com/api/v3action=statusapplication/x-www-form-urlencodedالمعاملات
| الاسم | النوع | الوصف |
|---|---|---|
| keyمطلوب | string | مفتاح API الخاص بك. |
| actionمطلوب | string | يجب أن يكون السلسلة النصية الحرفية "status". |
| order | string | معرّف رقمي لطلب واحد. إذا أُرسل كل من order وorders، تكون الأولوية لـ orders. |
| orders | string (CSV) | ما يصل إلى 100 معرّف رقمي للطلبات مفصولة بفواصل. إذا أُرسل كل من order وorders، تكون الأولوية لـ orders. |
مثال على الطلب
استبدل YOUR_API_KEY بالمفتاح المُولَّد ضمن صفحة API في لوحة تحكمك.
curl -X POST https://notpanel.com/api/v3 \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "key=YOUR_API_KEY&action=status&order=7001"const res = await fetch("https://notpanel.com/api/v3", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
key: "YOUR_API_KEY",
action: "status",
order: "7001",
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://notpanel.com/api/v3",
data={
"key": "YOUR_API_KEY",
"action": "status",
"order": "7001",
},
)
print(res.json())<?php
$body = http_build_query([
'key' => 'YOUR_API_KEY',
'action' => 'status',
'order' => '7001',
]);
$response = file_get_contents('https://notpanel.com/api/v3', false, stream_context_create([
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/x-www-form-urlencoded\r\n",
'content' => $body,
'ignore_errors' => true,
],
]));
print_r(json_decode($response, true));
مثال على الاستجابة
{
"status": "In progress",
"status_key": "in_progress",
"charge": "0.50",
"refund": "0.00",
"refund_pending": 0,
"refund_pending_amount": "0.00",
"start_count": "1234",
"remains": "650",
"currency": "USD",
"cancel_available": false,
"cancel_before": "2026-08-25T10:30:15.000Z",
"refund_guaranteed_at": "2026-09-01T10:30:00.000Z",
"refund_policy": "full_if_unresolved_after_7_days"
}الأخطاء الشائعة
| الحالة | الجسم | السبب |
|---|---|---|
| 400 | {"error":"Missing parameter: order"} | لم يُوفَّر order ولا orders. |
| 400 | {"error":"Order not found"} | معرّف الطلب الفردي غير موجود أو لا يخص حسابك. |
| 400 | {"error":"Maximum 100 orders per request"} | احتوى orders بصيغة CSV على أكثر من 100 معرّف. قسّمها إلى دُفعات. |