Panduan ini menunjukkan cara memperpanjang (renew) proxy yang sudah Anda miliki melalui API agar tetap memakai alamat IP yang sama. Perpanjang tepat waktu — setelah kedaluwarsa, IP bisa hilang.
Setiap permintaan menggunakan kunci API pribadi Anda dari dasbor akun (cara mendapatkan kunci API). Pada contoh di bawah, ganti YOUR_API_KEY dengan kunci Anda sendiri. Untuk membayar dari saldo akun, gunakan paymentId = 1.
⚠️ Langkah terakhir memotong saldo Anda. Selalu periksa biayanya dulu di langkah perhitungan.
Alur secara singkat
Temukan proxy yang akan diperpanjang dan salin ID-nya.
Pilih metode pembayaran (atau gunakan saldo).
Hitung biaya perpanjangan.
Lakukan perpanjangan.
Langkah 1 — Temukan proxy yang akan diperpanjang
Tampilkan proxy aktif Anda dan salin id setiap proxy yang ingin diperpanjang. Hanya proxy dengan can_prolong: true yang bisa diperpanjang. Catat tipe proxy (ipv4, ipv6, mobile, isp, mix, mix_isp) — diperlukan pada langkah berikutnya.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
Parameter path
Nama | Nilai | Deskripsi |
type (opsional) |
| Tipe proxy yang diambil. Jika dikosongkan, semua tipe dikembalikan. |
Parameter query opsional
Nama | Tipe | Deskripsi |
latest | String | Y/N — kembalikan proxy hanya dari pesanan terakhir. |
orderId | String | Kembalikan proxy dari orderId atau baseOrderNumber tertentu. |
country | String | Kode negara alpha-3 (mis. FRA, USA). |
ends | String | Y — hanya proxy yang akan kedaluwarsa. |
Contoh
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/ipv4
Respons
{
"status": "success",
"data": {
"items": [
{
"id": "0678564",
"order_id": "123456",
"ip": "31.6.33.97",
"protocol": "HTTP",
"port_http": 12345,
"port_socks": 12345,
"login": "ruht5734hg",
"password": "gou5h437g",
"country": "Belgium",
"country_alpha3": "BEL",
"status_type": "ACTIVE",
"can_prolong": true,
"date_start": "23.06.2024",
"date_end": "23.07.2024",
"auto_renew": "N"
}
]
},
"errors": []
}
Salin id setiap proxy yang akan diperpanjang. Pastikan can_prolong bernilai true.
Langkah 2 — Pilih metode pembayaran
Tampilkan sistem pembayaran yang tersedia dan salin id yang Anda inginkan sebagai paymentId. Untuk membayar dari saldo akun, Anda bisa melewati langkah ini dan cukup gunakan paymentId = 1.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list
Respons
{
"status": "success",
"data": {
"items": [
{ "id": "30", "name": "Visa / MasterCard" },
{ "id": "41", "name": "USDT (TRC-20)" },
{ "id": "29", "name": "PayPal" },
{ "id": "35", "name": "Binance" }
]
},
"errors": []
}
Langkah 3 — Hitung biaya perpanjangan
Sebelum membayar, hitung biayanya. Diskon volume dan periode sewa diterapkan sama seperti di situs. Langkah ini tidak memotong apa pun.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/{type}
Body permintaan
Nama | Tipe | Deskripsi |
ids | Number / Array | Satu ID atau array ID dalam |
periodId | String | ID periode perpanjangan. Dapatkan periode yang tersedia dari endpoint |
paymentId | String | ID sistem pembayaran. |
coupon (opsional) | String | Kode kupon, jika ada. |
Contoh
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/ipv4
Respons — shows the total, your balance, the discount and the proxies being renewed:
{
"status": "success",
"data": {
"warning": "",
"balance": 40.4,
"total": 35.1,
"quantity": 5,
"currency": "USD",
"discount": 0.22,
"items": [ ... proxies being renewed ... ],
"orders": 2
},
"errors": []
}
Jika saldo Anda terlalu rendah, Anda akan mendapat peringatan Insufficient funds:
{
"status": "error",
"data": {
"warning": "Insufficient funds. Total $2. Not enough $33.10",
"balance": 2,
"total": 35.1
},
"errors": []
}
Langkah 4 — Lakukan perpanjangan (memotong saldo)
Jika biaya yang dihitung sudah sesuai, buat pesanan perpanjangan. Langkah ini memotong saldo Anda. Gunakan parameter yang sama seperti pada Langkah 3.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/{type}
Body permintaan
Nama | Tipe | Deskripsi |
ids | Number / Array | Satu ID atau array ID dalam |
periodId | String | ID periode perpanjangan (dari |
paymentId | String | ID sistem pembayaran. |
coupon (opsional) | String | Kode kupon, jika ada. |
Contoh
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/ipv4
Respons — returns the new order ID and your updated balance:
{
"status": "success",
"data": {
"orderId": 3388536,
"total": 35.1,
"listBaseOrderNumbers": [ "1000000_57471911" ],
"balance": 40.4
},
"errors": []
}
Proxy tetap memakai IP yang sama dengan tanggal kedaluwarsa baru.
Referensi API lengkap
Extend proxies — hitung & lakukan perpanjangan
Retrieve active proxy — daftar proxy Anda
Balance — saldo & sistem pembayaran