Order
Refill
Order yang selesai bisa diisi ulang bila layanan mendukung. Setiap order bisa diisi ulang sekali setiap 6 jam, tanpa tanggal akhir. refill_status menampilkan hasilnya dan, bila ditolak, alasannya.
https://notpanel.com/api/v3action=refill- API key diperlukan
- Batas permintaan tercapai
- Body:
application/x-www-form-urlencoded
Parameter
Selalu dikirim
keystringWajib- API key Anda.
actionstringWajibrefillHarus berupa string literal "refill".
Kirim order atau orders.
orderintegerSalah satu dari ini- Satu nomor order. Balasannya adalah objek dengan ID isi ulang baru di
refill. ordersstring (CSV)Salah satu dari ini- Hingga 100 nomor order dipisahkan koma. Balasannya array; 30 ID order per menit.
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));
Ganti YOUR_API_KEY dengan kunci dari halaman API Anda.
{
"refill": 5501
}Error
- 404
{"error":"Order not found","error_code":"ORDER_NOT_FOUND","retryable":false}Tidak ada order seperti itu di akun Anda.
- 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"}}Isi ulang diminta kurang dari 6 jam yang lalu.
details.timemenyebutkan kapan Anda bisa bertanya lagi. - 409
{"error":"Refill is available after the order is completed","error_code":"REFILL_NOT_COMPLETED","retryable":true}Order masih berjalan. Isi ulang bisa dilakukan setelah selesai.
Kapan isi ulang bisa dilakukan
Order harus selesai atau sebagian, layanan harus mendukung isi ulang (flag refill-nya true), dan minimal 6 jam harus berlalu sejak permintaan isi ulang terakhir. Tidak ada batas waktu setelah order. Balasan order adalah ID isi ulang; can_refill dan refill_available_at di status memberi tahu Anda sebelumnya.
Banyak order
Dengan orders, balasannya adalah array dengan satu entri per order, masing-masing berisi ID isi ulang atau objek error. Masalah pada satu order tidak pernah menghentikan yang lain. Hingga 100 ID.
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 mengembalikan status satu isi ulang atau hingga 100. Isi ulang yang tidak dijawab siapa pun selama 7 hari berhenti dilacak dan tampil sebagai Pending, sehingga tidak menghalangi permintaan baru.
https://notpanel.com/api/v3action=refill_statusKirim refill atau refills
refillintegerSalah satu dari ini- Satu ID isi ulang.
refillsstring (CSV)Salah satu dari ini- Hingga 100 ID isi ulang dipisahkan koma.
Kolom respons
statusstring- Kata status. Lihat Nilai status di bawah.
status_keystring- Bentuk status yang stabil dalam huruf kecil.
orderinteger- Order tempat isi ulang ini berada.
reason_codestring | null- Mengapa isi ulang ditolak, atau
null. reasonstring | null- Kalimat bahasa Inggris tetap untuk
reason_code, ataunull. created_atstring- Kapan isi ulang diminta.
updated_atstring- Kapan terakhir berubah.
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
}
]Nilai status
- Pending
status_key=pendingPending— diminta, atau hasilnya belum diketahui. - In progress
status_key=in_progressIn progress— isi ulang sedang dikerjakan. - Completed
status_key=completedCompleted— isi ulang sudah dilakukan. - Rejected
status_key=rejectedRejected— isi ulang ditolak.reason_codemenjelaskan alasannya.
Alasan penolakan
Penolakan selalu membawa salah satu kode ini. Perlakukan kode yang tidak dikenal sebagai penolakan umum: kode baru bisa ditambahkan.
Kode alasan dan kalimatnya
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.
Error isi ulang
- 404
ORDER_NOT_FOUND
Order not foundTidak ada order dengan nomor ini di akun Anda. Perbaiki dulu permintaannya.
- 409
REFILL_NOT_AVAILABLE
Refill is not available for this orderIsi ulang tidak mungkin untuk order ini. Perbaiki dulu permintaannya.
- 409
REFILL_NOT_COMPLETED
Refill is available after the order is completedIsi ulang bisa dilakukan setelah order selesai. Mencoba ulang bisa membantu.
- 409
REFILL_COOLDOWN
You can request a refill again after {time}Isi ulang untuk order ini diminta belum lama ini. Coba lagi setelah details.time. Mencoba ulang bisa membantu.
- 409
REFILL_ALREADY_PENDING
A refill request is already in progress for this orderIsi ulang untuk order ini sudah sedang berjalan. Mencoba ulang bisa membantu.
- 404
REFILL_NOT_FOUND
Refill not foundTidak ada isi ulang dengan ID ini yang milik akun Anda. Perbaiki dulu permintaannya.