Заказы

Refill

Выполненный заказ можно восполнить, если услуга это поддерживает. Каждый заказ можно восполнять раз в 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
Восполнения с таким идентификатором нет в вашем аккаунте. Сначала исправьте запрос.

Заказы

Refill

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.

Ошибки восполнения

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
Восполнения с таким идентификатором нет в вашем аккаунте. Сначала исправьте запрос.

Refill

Параметры

Передаётся всегда

Передайте order или orders.

Ошибки

Когда возможно восполнение

Много заказов

refill_status

Передайте refill или refills

Поля ответа

Значения статуса

Причины отказа

Коды причин и фразы

Ошибки восполнения

Refill

Параметры

Передаётся всегда

Передайте order или orders.

Ошибки

Когда возможно восполнение

Много заказов

refill_status

Передайте refill или refills

Поля ответа

Значения статуса

Причины отказа

Коды причин и фразы

Ошибки восполнения

Передайте `order` или `orders`.

Передайте `refill` или `refills`

Передайте `order` или `orders`.

Передайте `refill` или `refills`