Запросить refill
Создаёт refill для допустимого заказа completed или partial после 24-часового ожидания. Общего лимита попыток нет, но одновременно только один refill может иметь статус pending, processing или находиться на проверке.
POST
https://notpanel.com/api/v3action=refillТребуется API-ключОграничение частоты (общий аккаунт + IP + действие)Тело:
application/x-www-form-urlencodedПараметры
| Название | Тип | Описание |
|---|---|---|
| keyОбязательный | string | Ваш API-ключ. |
| actionОбязательный | string | Должно быть буквальной строкой «refill». |
| order | string | ID одного заказа. Используйте order или orders; если переданы оба, orders имеет приоритет. |
| orders | string (CSV) | До 100 ID заказов через запятую для пакетного refill. Возвращает массив — каждая строка содержит либо ID refill, либо ошибку по заказу. |
Пример запроса
Замените 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=refill&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: "refill",
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": "refill",
"order": "7001",
},
)
print(res.json())<?php
$body = http_build_query([
'key' => 'YOUR_API_KEY',
'action' => 'refill',
'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));
Пример ответа
{
"refill": 8001
}Распространённые ошибки
| Статус | Тело | Причина |
|---|---|---|
| 400 | {"error":"Order not found"} | ID заказа не существует или не принадлежит вашему аккаунту. |
| 400 | {"error":"Refill only available for completed or partial orders"} | Заказ не имеет статус completed или partial. Другие статусы не допускают refill. |
| 400 | {"error":"Service does not support refills"} | У базовой услуги refill=false. Проверьте каталог services перед отправкой запросов на refill. |
| 400 | {"error":"A refill request is already pending for this order"} | Дождитесь завершения предыдущего refill, прежде чем создавать новый. |
| 400 | {"error":"Refill is available 24 hours after the order is completed"} | Заказ был завершён менее 24 часов назад. |