Ce guide explique comment renouveler (prolonger) vos proxys existants via l'API afin de conserver les mêmes adresses IP. Renouvelez à temps : une fois le proxy expiré, l'IP peut être perdue.

Chaque requête utilise votre clé API personnelle depuis le tableau de bord de votre compte (comment obtenir votre clé API). Dans les exemples ci-dessous, remplacez YOUR_API_KEY par votre propre clé. Pour payer avec le solde de votre compte, utilisez paymentId = 1.

⚠️ La dernière étape débite votre solde. Vérifiez toujours d'abord le coût à l'étape de calcul.

Le déroulement en un coup d'œil

Trouvez les proxys à renouveler et copiez leurs ID.
Choisissez un moyen de paiement (ou utilisez votre solde).
Calculez le coût du renouvellement.
Effectuez le renouvellement.

Étape 1 — Trouvez les proxys à renouveler

Listez vos proxys actifs et copiez l'id de chacun que vous souhaitez prolonger. Seuls les proxys avec can_prolong: true peuvent être renouvelés. Notez le type de proxy (ipv4, ipv6, mobile, isp, mix, mix_isp) — vous en aurez besoin aux étapes suivantes.

Endpoint

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

Paramètres de chemin

Nom	Valeur	Description
type (optionnel)	`ipv4`	Le type de proxy à récupérer. Si omis, tous les types sont renvoyés.

Paramètres de requête optionnels

Nom	Type	Description
latest	String	Y/N — renvoyer uniquement les proxys de la dernière commande.
orderId	String	Renvoyer les proxys d'un orderId ou baseOrderNumber spécifique.
country	String	Code pays alpha-3 (ex. FRA, USA).
ends	String	Y — uniquement les proxys sur le point d'expirer.

Exemple

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

Réponse

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

Copiez l'id de chaque proxy à renouveler. Assurez-vous que can_prolong est true.

Étape 2 — Choisissez un moyen de paiement

Listez les systèmes de paiement disponibles et copiez l'id souhaité comme paymentId. Pour payer avec le solde de votre compte, vous pouvez ignorer cette étape et utiliser simplement paymentId = 1.

Endpoint

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

Réponse

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

Étape 3 — Calculez le coût du renouvellement

Avant de payer, calculez le coût. Les remises sur volume et durée de location s'appliquent comme sur le site. Cette étape ne débite rien.

Endpoint

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

Corps de la requête

Nom	Type	Description
ids	Number / Array	Un seul ID ou un tableau d'IDs entre `[ ]`, séparés par des virgules — de l'étape 1.
periodId	String	ID de la période de renouvellement. Obtenez les périodes disponibles via l'endpoint `/reference/list/{type}`.
paymentId	String	ID du système de paiement. `1` = solde, `43` = carte enregistrée sur votre compte.
coupon (optionnel)	String	Un code promo, si vous en avez un.

Exemple

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

Réponse — 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": []
}

Si votre solde est trop bas, vous recevrez un avertissement Insufficient funds :

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

Étape 4 — Effectuez le renouvellement (débite votre solde)

Lorsque le coût calculé vous convient, créez la commande de renouvellement. Cette étape débite votre solde. Utilisez les mêmes paramètres qu'à l'étape 3.

Endpoint

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

Corps de la requête

Nom	Type	Description
ids	Number / Array	Un seul ID ou un tableau d'IDs entre `[ ]`, séparés par des virgules.
periodId	String	ID de la période de renouvellement (depuis `/reference/list/{type}`).
paymentId	String	ID du système de paiement. `1` = solde.
coupon (optionnel)	String	Un code promo, si vous en avez un.

Exemple

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

Réponse — returns the new order ID and your updated balance:

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

Les proxys conservent les mêmes IP avec une nouvelle date d'expiration.

Référence API complète

Extend proxies — calculer et effectuer le renouvellement
Retrieve active proxy — lister vos proxys
Balance — solde et systèmes de paiement

Prolonger (renouveler) les proxys

Le déroulement en un coup d'œil

Étape 1 — Trouvez les proxys à renouveler

Étape 2 — Choisissez un moyen de paiement

Étape 3 — Calculez le coût du renouvellement

Étape 4 — Effectuez le renouvellement (débite votre solde)

Référence API complète