Extend proxies

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:

POST https://proxy-seller.com/personal/api/v1/{YourApiKey}/prolong/calc/{type}

Example (e.g. ipv4):

https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/prolong/calc/ipv4

Response:

200: OK Success 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
      }
    ],
    "orders": 2
  },
  "errors": []
}

200: OK Error response Insufficient fund on balance

{
  "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": []
}

200: OK Error response Wrong periodId

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Set existed [periodId] from reference",
            "code": 0,
            "customData": null
        }
    ]
}

200: OK Error response Wrong ids

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP not found",
            "code": 0,
            "customData": null
        }
    ]
}

Path parameters:

Name	Value	Description
Authorization	<Your_API_Key>	Your personal API key (how to get)
Proxy type	ipv4 ipv6 mobile isp mix mix_isp	The proxy type you want to extend

Request body:

Name	Type	Description
ids	Number	A single ID or an array of IDs in '[ ]', separated by commas (how to get)
coupon	String	The comment you want to add
periodId	String	ID of the period you selected in the /reference/list/{type} request
paymentId	String	The ID of the payment system. '1' for balance, '43' for the card added to your account.

Create a renewal order

In this section you will learn how to create renewal order.

Endpoint:

POST https://proxy-seller.com/personal/api/v1/{YourApiKey}/prolong/make/{type}

Example (e.g. ipv4):

https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/prolong/make/ipv4

Response:

200: OK Success response

{
  "status": "success",
  "data": {
        "orderId": 3388536,
        "total": 35.1,
        "listBaseOrderNumbers": [
            "1000000_57471911"
        ],
        "balance": 40.4,
  },
  "errors": []
}

200: OK Error response Insufficient fund on balance

{
  "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": []
}

200: OK Error response Wrong periodId

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Set existed [periodId] from reference",
            "code": 0,
            "customData": null
        }
    ]
}

200: OK Error response Wrong ids

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP not found",
            "code": 0,
            "customData": null
        }
    ]
}

Path parametrs:

Name	Value	Description
Authorization	<Your_API_Key>	Your personal API key (how to get)
Proxy type	ipv4 ipv6 mobile isp mix mix_isp	Proxy type that you want to prolong

Request body:

Name	Type	Description
ids	Number	One or array in ids of "[ ]", separated by commas
coupon	String	Comment which you want to add
peroidId	String	ID of the period you selected in the /reference/list/{type} request
paymentId	String	Id's of payments system "1" - balance, "43" - card that you added in your cabinet