Este guia mostra como renovar (estender) os proxies que você já possui pela API, mantendo os mesmos endereços IP. Renove a tempo — após expirar, o IP pode ser perdido.

Cada requisição usa sua chave de API pessoal do painel da sua conta (como obter sua chave de API). Nos exemplos abaixo, substitua YOUR_API_KEY pela sua própria chave. Para pagar com o saldo da conta, use paymentId = 1.

⚠️ A última etapa debita do seu saldo. Sempre verifique o custo primeiro na etapa de cálculo.

O fluxo em resumo

Encontre os proxies a renovar e copie seus IDs.
Escolha um método de pagamento (ou use seu saldo).
Calcule o custo da renovação.
Faça a renovação.

Passo 1 — Encontre os proxies a renovar

Liste seus proxies ativos e copie o id de cada um que deseja estender. Apenas proxies com can_prolong: true podem ser renovados. Anote o tipo de proxy (ipv4, ipv6, mobile, isp, mix, mix_isp) — você precisará dele nos próximos passos.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}

Parâmetros de caminho

Nome	Valor	Descrição
type (opcional)	`ipv4`	O tipo de proxy a obter. Se omitido, todos os tipos são retornados.

Parâmetros de consulta opcionais

Nome	Tipo	Descrição
latest	String	Y/N — retorna apenas os proxies do último pedido.
orderId	String	Retorna proxies de um orderId ou baseOrderNumber específico.
country	String	Código de país alfa-3 (ex. FRA, USA).
ends	String	Y — apenas proxies prestes a expirar.

Exemplo

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/ipv4

Resposta

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

Copie o id de cada proxy a renovar. Verifique se can_prolong é true.

Passo 2 — Escolha um método de pagamento

Liste os sistemas de pagamento disponíveis e copie o id desejado como paymentId. Para pagar com o saldo da conta, você pode pular esta etapa e usar simplesmente paymentId = 1.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list

Resposta

{
  "status": "success",
  "data": {
    "items": [
      { "id": "30", "name": "Visa / MasterCard" },
      { "id": "41", "name": "USDT (TRC-20)" },
      { "id": "29", "name": "PayPal" },
      { "id": "35", "name": "Binance" }
    ]
  },
  "errors": []
}

Passo 3 — Calcule o custo da renovação

Antes de pagar, calcule o custo. Descontos por volume e período de aluguel são aplicados como no site. Esta etapa não cobra nada.

Endpoint

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

Corpo da requisição

Nome	Tipo	Descrição
ids	Number / Array	Um único ID ou um array de IDs em `[ ]`, separados por vírgulas — do passo 1.
periodId	String	ID do período de renovação. Obtenha os períodos disponíveis no endpoint `/reference/list/{type}`.
paymentId	String	ID do sistema de pagamento. `1` = saldo, `43` = cartão adicionado à sua conta.
coupon (opcional)	String	Um código de cupom, se você tiver.

Exemplo

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

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

Se o seu saldo for muito baixo, você receberá um aviso Insufficient funds:

{
  "status": "error",
  "data": {
    "warning": "Insufficient funds. Total $2. Not enough $33.10",
    "balance": 2,
    "total": 35.1
  },
  "errors": []
}

Passo 4 — Faça a renovação (debita do seu saldo)

Quando o custo calculado estiver certo, crie o pedido de renovação. Esta etapa debita do seu saldo. Use os mesmos parâmetros do passo 3.

Endpoint

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

Corpo da requisição

Nome	Tipo	Descrição
ids	Number / Array	Um único ID ou um array de IDs em `[ ]`, separados por vírgulas.
periodId	String	ID do período de renovação (de `/reference/list/{type}`).
paymentId	String	ID do sistema de pagamento. `1` = saldo.
coupon (opcional)	String	Um código de cupom, se você tiver.

Exemplo

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

Resposta — returns the new order ID and your updated balance:

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

Os proxies mantêm os mesmos IPs com uma nova data de expiração.

Referência completa da API

Extend proxies — calcular e fazer a renovação
Retrieve active proxy — liste seus proxies
Balance — saldo e sistemas de pagamento

Estender (renovar) proxies

O fluxo em resumo

Passo 1 — Encontre os proxies a renovar

Passo 2 — Escolha um método de pagamento

Passo 3 — Calcule o custo da renovação

Passo 4 — Faça a renovação (debita do seu saldo)

Referência completa da API