Extend proxies
Updated:
This document provides a detailed guide on how to set up automatic renewal for your IP addresses of various types. Please note that IP addresses must be renewed on time to maintain the same addresses.
Calculate extension
This endpoint helps you calculate the cost. Discounts for volume and rental periods are similar to those offered by our service.
Endpoint:
Path parameters
Name | Value | Description |
|---|---|---|
Authorization |
| Your personal API key (how to get) |
Proxy type |
| The proxy type you want to extend |
Request body
Name | Type | Description |
|---|---|---|
ids | String | A single ID or an array of IDs in '[ ]', separated by commas |
coupon | String | The comment you want to add |
periodId | String | ID of the period you selected in the /reference/list/{type} request or stable period code, for example 1m |
paymentId | String | The ID of the payment system. 'balance' for balance, 'card' for the card added to your account. |
Name | Type | Description |
|---|---|---|
orderIds | String | A single ID or an array of orderIDs in '[ ]', separated by commas |
coupon | String | The comment you want to add |
periodId | String | ID of the period you selected in the /reference/list/{type} request or stable period code, for example 1m |
paymentId | String | The ID of the payment system. 'balance' for balance, 'card' for the card added to your account. |
Example (e.g. ipv4)
https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/prolong/calc/ipv4
{
"ids": ["10"],
"periodId": "1m",
"coupon": "",
"paymentId": "balance"
}Response
{
"status": "success",
"data": {
"warning": "",
"balance": 40.4,
"total": 35.1,
"quantity": 5,
"currency": "USD",
"discount": 0.22,
"items": [
{
"id": 10,
"order_id": 1000000,
"order_number": "1000000_57471911",
"base_order_number": "1000000_57471911",
"ip": "127.0.0.1",
"port_http": 80,
"port_socks": 443,
"login": "login",
"password": "password",
"auth_ip": "127.0.0.2",
"country": "USA",
"date_start": "d.m.Y H:i:s",
"date_end": "d.m.Y H:i:s",
"comment": "d.m.Y H:i:s",
"status": "ACTIVE",
"rotation": "5",
"link_reboot": "https://proxy-seller.com/api/proxy/reboot?token=12345",
"can_prolong": true,
"uptime": false
}
],
"orders": 2
},
"errors": []
}{
"status": "error",
"data": {
"warning": "Insufficient funds. Total $2. Not enough $33.10",
"balance": 2,
"total": 35.1,
"quantity": 5,
"currency": "USD",
"discount": 0.22,
"items": [
{
"id": 10,
"order_id": 1000000,
"ip": "127.0.0.1",
"port_http": 80,
"port_socks": 443,
"login": "login",
"password": "password",
"auth_ip": "127.0.0.2",
"country": "USA",
"date_start": "d.m.Y H:i:s",
"date_end": "d.m.Y H:i:s",
"comment": "d.m.Y H:i:s",
"status": "ACTIVE",
"rotation": "5",
"link_reboot": "https://proxy-seller.com/api/proxy/reboot?token=12345",
"can_prolong": true,
"uptime": false
}
],
"orders": 2
},
"errors": []
}{
"status": "error",
"data": null,
"errors": [
{
"message": "Set existed [periodId] from reference",
"code": 0,
"customData": null
}
]
}{
"status": "error",
"data": null,
"errors": [
{
"message": "IP not found",
"code": 0,
"customData": null
}
]
}Create a renewal order
In this section you will learn how to create renewal order.
Endpoint:
Path parameters
Name | Value | Description |
|---|---|---|
Authorization |
| Your personal API key (how to get) |
Proxy type |
| Proxy type that you want to prolong |
Request body
Name | Type | Description |
|---|---|---|
ids | String | A single ID or an array of IDs in '[ ]', separated by commas |
coupon | String | The comment you want to add |
periodId | String | ID of the period you selected in the /reference/list/{type} request or stable period code, for example 1m |
paymentId | String | The ID of the payment system. 'balance' for balance, 'card' for the card added to your account. |
Name | Type | Description |
|---|---|---|
orderIds | String | A single ID or an array of orderIDs in '[ ]', separated by commas |
coupon | String | The comment you want to add |
periodId | String | ID of the period you selected in the /reference/list/{type} request or stable period code, for example 1m |
paymentId | String | The ID of the payment system. 'balance' for balance, 'card' for the card added to your account. |
Example (e.g. ipv4)
https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/prolong/make/ipv4
{
"ids": ["10"],
"periodId": "1m",
"coupon": "",
"paymentId": "balance"
}Response
{
"status": "success",
"data": {
"orderId": 3388536,
"total": 35.1,
"listBaseOrderNumbers": [
"1000000_57471911"
],
"balance": 40.4,
},
"errors": []
}{
"status": "error",
"data": {
"warning": "Insufficient funds. Total $2. Not enough $33.10",
"balance": 2,
"total": 35.1,
"quantity": 5,
"currency": "USD",
"discount": 0.22,
"items": [
{
"id": 10,
"order_id": 1000000,
"ip": "127.0.0.1",
"port_http": 80,
"port_socks": 443,
"login": "login",
"password": "password",
"auth_ip": "127.0.0.2",
"country": "USA",
"date_start": "d.m.Y H:i:s",
"date_end": "d.m.Y H:i:s",
"comment": "d.m.Y H:i:s",
"status": "ACTIVE",
"rotation": "5",
"link_reboot": "https://proxy-seller.com/api/proxy/reboot?token=12345",
"can_prolong": true
}
],
"orders": 2
},
"errors": []
}{
"status": "error",
"data": null,
"errors": [
{
"message": "Set existed [periodId] from reference",
"code": 0,
"customData": null
}
]
}{
"status": "error",
"data": null,
"errors": [
{
"message": "IP not found",
"code": 0,
"customData": null
}
]
}