الطلبات

إعادة التعبئة

يمكن إعادة تعبئة الطلب المكتمل عندما تدعم الخدمة ذلك. يمكن إعادة تعبئة كل طلب مرة كل 6 ساعة، دون تاريخ انتهاء. يعرض refill_status النتيجة، والسبب إن رُفضت.

POSThttps://notpanel.com/api/v3action=refill

مفتاح API مطلوب
تجاوز حد الطلبات
الجسم:application/x-www-form-urlencoded

كل 6 ساعة

طلب إعادة تعبئة واحد لكل طلب كل 6 ساعة، تُحسب من الطلب السابق أيًّا كانت نتيجته. إن سألت مبكرًا جدًا تحصل على REFILL_COOLDOWN مع الوقت الذي يمكنك فيه السؤال.

المعاملات

يُرسل دائمًا

keystringمطلوب: مفتاح API الخاص بك.
actionstringمطلوب: refillيجب أن يكون السلسلة النصية الحرفية "refill".

أرسل `order` أو `orders`.

orderintegerأحد هذه: رقم طلب واحد. الردّ كائن فيه معرّف إعادة التعبئة الجديد في refill.
ordersstring (CSV)أحد هذه: حتى 100 من أرقام الطلبات مفصولة بفواصل. الردّ مصفوفة؛ و30 من معرّفات الطلبات في الدقيقة.

curl -X POST https://notpanel.com/api/v3 \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY&action=refill&order=1234567"

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: "refill",
    order: "1234567",
  }),
});

const data = await res.json();
console.log(data);

import requests

res = requests.post(
  "https://notpanel.com/api/v3",
  data={
    "key": "YOUR_API_KEY",
    "action": "refill",
    "order": "1234567",
},
)
print(res.json())

<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'refill',
    'order' => '1234567',
]);

$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));

استبدل YOUR_API_KEY بالمفتاح من صفحة API.

الاستجابة200 OK

{
  "refill": 5501
}

الأخطاء

404
{"error":"Order not found","error_code":"ORDER_NOT_FOUND","retryable":false}
لا يوجد مثل هذا الطلب في حسابك.
409
{"error":"You can request a refill again after 2026-10-03T18:35:00.000Z","error_code":"REFILL_COOLDOWN","retryable":true,"details":{"time":"2026-10-03T18:35:00.000Z"}}
طُلبت إعادة تعبئة قبل أقل من 6 ساعة. يبيّن details.time متى يمكنك السؤال مجددًا.
409
{"error":"Refill is available after the order is completed","error_code":"REFILL_NOT_COMPLETED","retryable":true}
الطلب ما زال قيد التنفيذ. إعادة التعبئة ممكنة بعد اكتماله.

كل رموز الحالة

متى تكون إعادة التعبئة ممكنة

يجب أن يكون الطلب مكتملًا أو جزئيًا، وأن تدعم الخدمة إعادة التعبئة (علامة refill فيها true)، وأن تمر 6 ساعة على الأقل منذ آخر طلب إعادة تعبئة. لا يوجد حد زمني بعد الطلب. الردّ على order هو معرّف إعادة التعبئة؛ ويخبرك can_refill وrefill_available_at في status بذلك مسبقًا.

سرد الخدمات

عدة طلبات

مع orders يكون الردّ مصفوفة فيها مدخل واحد لكل طلب، وفي كل مدخل معرّف إعادة التعبئة أو كائن خطأ. مشكلة في طلب واحد لا توقف الباقي أبدًا. حتى 100 معرّفًا.

الطلب

key=YOUR_API_KEY&action=refill&orders=1234567,1234568,1234577

الاستجابة200 OK

[
  {
    "order": 1234567,
    "refill": 5501
  },
  {
    "order": 1234568,
    "refill": {
      "error": "You can request a refill again after 2026-10-03T18:35:00.000Z",
      "error_code": "REFILL_COOLDOWN",
      "retryable": true,
      "details": {
        "time": "2026-10-03T18:35:00.000Z"
      }
    }
  },
  {
    "order": 1234577,
    "refill": {
      "error": "Refill is available after the order is completed",
      "error_code": "REFILL_NOT_COMPLETED",
      "retryable": true
    }
  }
]

refill_status

يعيد action=refill_status حالة إعادة تعبئة واحدة أو حتى 100. إعادة التعبئة التي لا يجيب عنها أحد خلال 7 أيام تتوقف متابعتها وتظهر Pending، فلا تحجب طلبًا جديدًا.

POSThttps://notpanel.com/api/v3action=refill_status

أرسل `refill` أو `refills`

refillintegerأحد هذه: معرّف إعادة تعبئة واحد.
refillsstring (CSV)أحد هذه: حتى 100 من معرّفات إعادة التعبئة مفصولة بفواصل.

حقول الاستجابة

statusstring: كلمة الحالة. انظر قيم الحالة أدناه.
status_keystring: صيغة ثابتة بأحرف صغيرة للحالة.
orderinteger: الطلب الذي تتبع له إعادة التعبئة.
reason_codestring | null: سبب رفض إعادة التعبئة، أو null.
reasonstring | null: جملة إنجليزية ثابتة لـ reason_code، أو null.
created_atstring: متى طُلبت إعادة التعبئة.
updated_atstring: متى تغيّرت آخر مرة.

الطلب

key=YOUR_API_KEY&action=refill_status&refill=5501

الاستجابة200 OK

{
  "status": "Completed",
  "status_key": "completed",
  "order": 1234567,
  "reason_code": null,
  "reason": null,
  "created_at": "2026-10-03T12:35:00Z",
  "updated_at": "2026-10-03T13:05:00Z"
}

الطلب

key=YOUR_API_KEY&action=refill_status&refills=5501,5502,9

الاستجابة200 OK

[
  {
    "refill": 5501,
    "status": "Completed",
    "status_key": "completed",
    "order": 1234567,
    "reason_code": null,
    "reason": null,
    "created_at": "2026-10-03T12:35:00Z",
    "updated_at": "2026-10-03T13:05:00Z"
  },
  {
    "refill": 5502,
    "status": "Rejected",
    "status_key": "rejected",
    "order": 1234568,
    "reason_code": "refill_too_early",
    "reason": "This order cannot be refilled yet. Try again later.",
    "created_at": "2026-10-03T12:40:00Z",
    "updated_at": "2026-10-03T12:41:00Z"
  },
  {
    "refill": 9,
    "error": "Refill not found",
    "error_code": "REFILL_NOT_FOUND",
    "retryable": false
  }
]

قيم الحالة

Pendingstatus_key=pending
Pending — طُلبت، أو أن النتيجة غير معروفة بعد.
In progressstatus_key=in_progress
In progress — إعادة التعبئة قيد التنفيذ.
Completedstatus_key=completed
Completed — تمت إعادة التعبئة.
Rejectedstatus_key=rejected
Rejected — رُفضت إعادة التعبئة. يوضح reason_code السبب.

أسباب الرفض

يحمل الرفض دائمًا أحد هذه الرموز. عامل أي رمز غير معروف على أنه رفض عام: قد تُضاف رموز جديدة.

رموز الأسباب وجُملها

refill_too_early: This order cannot be refilled yet. Try again later.
refill_daily_limit: Refills for today are used up. Try again tomorrow.
refill_not_completed: Refill is possible after the order is completed.
refill_not_eligible: This order cannot be refilled.
refill_refused: The refill was not accepted. Try again later.

عندما تُطلب إعادة تعبئة ولا يجيب أحد، تبقى Pending ولا تُرسل مرتين بالخطأ.

أخطاء إعادة التعبئة

404
ORDER_NOT_FOUND
Order not found
لا يوجد طلب بهذا الرقم يخص حسابك. صحّح الطلب أولًا.
409
REFILL_NOT_AVAILABLE
Refill is not available for this order
لا يمكن إعادة تعبئة هذا الطلب. صحّح الطلب أولًا.
409
REFILL_NOT_COMPLETED
Refill is available after the order is completed
يمكن إعادة التعبئة بعد اكتمال الطلب. قد تفيد إعادة المحاولة.
409
REFILL_COOLDOWN
You can request a refill again after {time}
طُلبت إعادة تعبئة لهذا الطلب قبل وقت قصير. حاول مجددًا بعد details.time. قد تفيد إعادة المحاولة.
409
REFILL_ALREADY_PENDING
A refill request is already in progress for this order
توجد إعادة تعبئة قيد التنفيذ بالفعل لهذا الطلب. قد تفيد إعادة المحاولة.
404
REFILL_NOT_FOUND
Refill not found
لا توجد إعادة تعبئة بهذا المعرّف تخص حسابك. صحّح الطلب أولًا.

الطلبات

إعادة التعبئة

POSThttps://notpanel.com/api/v3action=refill

مفتاح API مطلوب
تجاوز حد الطلبات
الجسم:application/x-www-form-urlencoded

كل 6 ساعة

المعاملات

يُرسل دائمًا

keystringمطلوب: مفتاح API الخاص بك.
actionstringمطلوب: refillيجب أن يكون السلسلة النصية الحرفية "refill".

أرسل `order` أو `orders`.

orderintegerأحد هذه: رقم طلب واحد. الردّ كائن فيه معرّف إعادة التعبئة الجديد في refill.
ordersstring (CSV)أحد هذه: حتى 100 من أرقام الطلبات مفصولة بفواصل. الردّ مصفوفة؛ و30 من معرّفات الطلبات في الدقيقة.

curl -X POST https://notpanel.com/api/v3 \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY&action=refill&order=1234567"

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: "refill",
    order: "1234567",
  }),
});

const data = await res.json();
console.log(data);

import requests

res = requests.post(
  "https://notpanel.com/api/v3",
  data={
    "key": "YOUR_API_KEY",
    "action": "refill",
    "order": "1234567",
},
)
print(res.json())

<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'refill',
    'order' => '1234567',
]);

$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));

استبدل YOUR_API_KEY بالمفتاح من صفحة API.

الاستجابة200 OK

{
  "refill": 5501
}

الأخطاء

404
{"error":"Order not found","error_code":"ORDER_NOT_FOUND","retryable":false}
لا يوجد مثل هذا الطلب في حسابك.
409
{"error":"You can request a refill again after 2026-10-03T18:35:00.000Z","error_code":"REFILL_COOLDOWN","retryable":true,"details":{"time":"2026-10-03T18:35:00.000Z"}}
طُلبت إعادة تعبئة قبل أقل من 6 ساعة. يبيّن details.time متى يمكنك السؤال مجددًا.
409
{"error":"Refill is available after the order is completed","error_code":"REFILL_NOT_COMPLETED","retryable":true}
الطلب ما زال قيد التنفيذ. إعادة التعبئة ممكنة بعد اكتماله.

كل رموز الحالة

متى تكون إعادة التعبئة ممكنة

سرد الخدمات

عدة طلبات

الطلب

key=YOUR_API_KEY&action=refill&orders=1234567,1234568,1234577

الاستجابة200 OK

[
  {
    "order": 1234567,
    "refill": 5501
  },
  {
    "order": 1234568,
    "refill": {
      "error": "You can request a refill again after 2026-10-03T18:35:00.000Z",
      "error_code": "REFILL_COOLDOWN",
      "retryable": true,
      "details": {
        "time": "2026-10-03T18:35:00.000Z"
      }
    }
  },
  {
    "order": 1234577,
    "refill": {
      "error": "Refill is available after the order is completed",
      "error_code": "REFILL_NOT_COMPLETED",
      "retryable": true
    }
  }
]

refill_status

POSThttps://notpanel.com/api/v3action=refill_status

أرسل `refill` أو `refills`

refillintegerأحد هذه: معرّف إعادة تعبئة واحد.
refillsstring (CSV)أحد هذه: حتى 100 من معرّفات إعادة التعبئة مفصولة بفواصل.

حقول الاستجابة

statusstring: كلمة الحالة. انظر قيم الحالة أدناه.
status_keystring: صيغة ثابتة بأحرف صغيرة للحالة.
orderinteger: الطلب الذي تتبع له إعادة التعبئة.
reason_codestring | null: سبب رفض إعادة التعبئة، أو null.
reasonstring | null: جملة إنجليزية ثابتة لـ reason_code، أو null.
created_atstring: متى طُلبت إعادة التعبئة.
updated_atstring: متى تغيّرت آخر مرة.

الطلب

key=YOUR_API_KEY&action=refill_status&refill=5501

الاستجابة200 OK

{
  "status": "Completed",
  "status_key": "completed",
  "order": 1234567,
  "reason_code": null,
  "reason": null,
  "created_at": "2026-10-03T12:35:00Z",
  "updated_at": "2026-10-03T13:05:00Z"
}

الطلب

key=YOUR_API_KEY&action=refill_status&refills=5501,5502,9

الاستجابة200 OK

[
  {
    "refill": 5501,
    "status": "Completed",
    "status_key": "completed",
    "order": 1234567,
    "reason_code": null,
    "reason": null,
    "created_at": "2026-10-03T12:35:00Z",
    "updated_at": "2026-10-03T13:05:00Z"
  },
  {
    "refill": 5502,
    "status": "Rejected",
    "status_key": "rejected",
    "order": 1234568,
    "reason_code": "refill_too_early",
    "reason": "This order cannot be refilled yet. Try again later.",
    "created_at": "2026-10-03T12:40:00Z",
    "updated_at": "2026-10-03T12:41:00Z"
  },
  {
    "refill": 9,
    "error": "Refill not found",
    "error_code": "REFILL_NOT_FOUND",
    "retryable": false
  }
]

قيم الحالة

Pendingstatus_key=pending
Pending — طُلبت، أو أن النتيجة غير معروفة بعد.
In progressstatus_key=in_progress
In progress — إعادة التعبئة قيد التنفيذ.
Completedstatus_key=completed
Completed — تمت إعادة التعبئة.
Rejectedstatus_key=rejected
Rejected — رُفضت إعادة التعبئة. يوضح reason_code السبب.

أسباب الرفض

يحمل الرفض دائمًا أحد هذه الرموز. عامل أي رمز غير معروف على أنه رفض عام: قد تُضاف رموز جديدة.

رموز الأسباب وجُملها

refill_too_early: This order cannot be refilled yet. Try again later.
refill_daily_limit: Refills for today are used up. Try again tomorrow.
refill_not_completed: Refill is possible after the order is completed.
refill_not_eligible: This order cannot be refilled.
refill_refused: The refill was not accepted. Try again later.

عندما تُطلب إعادة تعبئة ولا يجيب أحد، تبقى Pending ولا تُرسل مرتين بالخطأ.

أخطاء إعادة التعبئة

404
ORDER_NOT_FOUND
Order not found
لا يوجد طلب بهذا الرقم يخص حسابك. صحّح الطلب أولًا.
409
REFILL_NOT_AVAILABLE
Refill is not available for this order
لا يمكن إعادة تعبئة هذا الطلب. صحّح الطلب أولًا.
409
REFILL_NOT_COMPLETED
Refill is available after the order is completed
يمكن إعادة التعبئة بعد اكتمال الطلب. قد تفيد إعادة المحاولة.
409
REFILL_COOLDOWN
You can request a refill again after {time}
طُلبت إعادة تعبئة لهذا الطلب قبل وقت قصير. حاول مجددًا بعد details.time. قد تفيد إعادة المحاولة.
409
REFILL_ALREADY_PENDING
A refill request is already in progress for this order
توجد إعادة تعبئة قيد التنفيذ بالفعل لهذا الطلب. قد تفيد إعادة المحاولة.
404
REFILL_NOT_FOUND
Refill not found
لا توجد إعادة تعبئة بهذا المعرّف تخص حسابك. صحّح الطلب أولًا.

إعادة التعبئة

المعاملات

يُرسل دائمًا

أرسل order أو orders.

الأخطاء

متى تكون إعادة التعبئة ممكنة

عدة طلبات

refill_status

أرسل refill أو refills

حقول الاستجابة

قيم الحالة

أسباب الرفض

رموز الأسباب وجُملها

أخطاء إعادة التعبئة

إعادة التعبئة

المعاملات

يُرسل دائمًا

أرسل order أو orders.

الأخطاء

متى تكون إعادة التعبئة ممكنة

عدة طلبات

refill_status

أرسل refill أو refills

حقول الاستجابة

قيم الحالة

أسباب الرفض

رموز الأسباب وجُملها

أخطاء إعادة التعبئة

أرسل `order` أو `orders`.

أرسل `refill` أو `refills`

أرسل `order` أو `orders`.

أرسل `refill` أو `refills`