Siparişler
Yeniden dolum
Tamamlanmış bir sipariş, hizmet destekliyorsa yenilenebilir. Her sipariş, bitiş tarihi olmadan 6 saatte bir yenilenebilir. refill_status sonucu ve reddedildiyse nedenini gösterir.
https://notpanel.com/api/v3action=refill- API anahtarı gerekli
- İstek limiti aşıldı
- Gövde:
application/x-www-form-urlencoded
Parametreler
Her zaman gönderilir
keystringZorunlu- API anahtarınız.
actionstringZorunlurefillBirebir "refill" dizesi olmalıdır.
order veya orders gönderin.
orderintegerBunlardan biri- Bir sipariş numarası. Yanıt,
refilliçinde yeni yenileme kimliği olan bir nesnedir. ordersstring (CSV)Bunlardan biri- Virgülle ayrılmış en fazla 100 sipariş numarası. Yanıt bir dizidir; dakikada 30 sipariş kimliği.
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 yerine API sayfanızdaki anahtarı yazın.
{
"refill": 5501
}Hatalar
- 404
{"error":"Order not found","error_code":"ORDER_NOT_FOUND","retryable":false}Hesabınızda böyle bir sipariş yok.
- 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"}}Bir yenileme 6 saatten kısa süre önce talep edildi.
details.timene zaman yeniden sorabileceğinizi söyler. - 409
{"error":"Refill is available after the order is completed","error_code":"REFILL_NOT_COMPLETED","retryable":true}Sipariş hâlâ çalışıyor. Yenileme, tamamlandıktan sonra mümkündür.
Yenileme ne zaman mümkün
Sipariş tamamlanmış veya kısmi olmalı, hizmet yenilemeyi desteklemeli (refill bayrağı true) ve son yenileme talebinden bu yana en az 6 saat geçmiş olmalıdır. Siparişten sonra zaman sınırı yoktur. order yanıtı yenileme kimliğidir; status içindeki can_refill ve refill_available_at bunu önceden söyler.
Çok sayıda sipariş
orders ile yanıt, sipariş başına bir girdi içeren bir dizidir; her girdi yenileme kimliğini veya bir hata nesnesini taşır. Bir siparişteki sorun diğerlerini asla durdurmaz. En fazla 100 kimlik.
key=YOUR_API_KEY&action=refill&orders=1234567,1234568,1234577[
{
"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, bir yenilemenin veya en fazla 100 yenilemenin durumunu döndürür. 7 gün boyunca kimsenin yanıtlamadığı bir yenileme takip edilmeyi bırakır ve Pending olarak görünür; böylece yeni bir talebi engellemez.
https://notpanel.com/api/v3action=refill_statusrefill veya refills gönderin
refillintegerBunlardan biri- Bir yenileme kimliği.
refillsstring (CSV)Bunlardan biri- Virgülle ayrılmış en fazla 100 yenileme kimliği.
Yanıt alanları
statusstring- Durum sözcüğü. Aşağıdaki Durum değerleri bölümüne bakın.
status_keystring- Durumun sabit küçük harfli biçimi.
orderinteger- Yenilemenin ait olduğu sipariş.
reason_codestring | null- Bir yenilemenin neden reddedildiği veya
null. reasonstring | nullreason_codeiçin sabit bir İngilizce cümle veyanull.created_atstring- Yenilemenin talep edildiği zaman.
updated_atstring- En son değiştiği zaman.
key=YOUR_API_KEY&action=refill_status&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"
}key=YOUR_API_KEY&action=refill_status&refills=5501,5502,9[
{
"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
}
]Durum değerleri
- Pending
status_key=pendingPending— talep edildi veya sonuç henüz bilinmiyor. - In progress
status_key=in_progressIn progress— yenileme yapılıyor. - Completed
status_key=completedCompleted— yenileme yapıldı. - Rejected
status_key=rejectedRejected— yenileme reddedildi.reason_codenedenini söyler.
Ret nedenleri
Bir ret her zaman bu kodlardan birini taşır. Bilinmeyen bir kodu genel bir ret olarak ele alın: yeni kodlar eklenebilir.
Neden kodları ve cümleler
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.
Yenileme hataları
- 404
ORDER_NOT_FOUND
Order not foundBu numaralı hiçbir sipariş hesabınıza ait değil. Önce isteği düzeltin.
- 409
REFILL_NOT_AVAILABLE
Refill is not available for this orderBu sipariş için yenileme mümkün değil. Önce isteği düzeltin.
- 409
REFILL_NOT_COMPLETED
Refill is available after the order is completedYenileme, sipariş tamamlandıktan sonra mümkündür. Yeniden denemek işe yarayabilir.
- 409
REFILL_COOLDOWN
You can request a refill again after {time}Bu sipariş için yakın zamanda yenileme talep edildi. details.time sonrasında tekrar deneyin. Yeniden denemek işe yarayabilir.
- 409
REFILL_ALREADY_PENDING
A refill request is already in progress for this orderBu sipariş için zaten devam eden bir yenileme var. Yeniden denemek işe yarayabilir.
- 404
REFILL_NOT_FOUND
Refill not foundBu kimliğe sahip hiçbir yenileme hesabınıza ait değil. Önce isteği düzeltin.