Diese Anleitung zeigt, wie du deine vorhandenen Proxys über die API verlängerst (erneuerst), damit du dieselben IP-Adressen behältst. Verlängere rechtzeitig — nach Ablauf kann die IP verloren gehen.

Jede Anfrage verwendet deinen persönlichen API-Schlüssel aus deinem Konto-Dashboard (So erhältst du deinen API-Schlüssel). Ersetze in den folgenden Beispielen YOUR_API_KEY durch deinen eigenen Schlüssel. Um vom Kontoguthaben zu bezahlen, verwende paymentId = 1.

⚠️ Der letzte Schritt belastet dein Guthaben. Prüfe die Kosten immer zuerst im Berechnungsschritt.

Der Ablauf im Überblick

Finde die zu verlängernden Proxys und kopiere ihre IDs.
Wähle eine Zahlungsmethode (oder nutze dein Guthaben).
Berechne die Verlängerungskosten.
Führe die Verlängerung durch.

Schritt 1 — Finde die zu verlängernden Proxys

Liste deine aktiven Proxys auf und kopiere die id jedes Proxys, den du verlängern möchtest. Nur Proxys mit can_prolong: true können verlängert werden. Notiere den Proxy-Typ (ipv4, ipv6, mobile, isp, mix, mix_isp) — du brauchst ihn in den nächsten Schritten.

Endpunkt

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

Pfadparameter

Name	Wert	Beschreibung
type (optional)	`ipv4`	Der abzurufende Proxy-Typ. Wenn weggelassen, werden alle Typen zurückgegeben.

Optionale Query-Parameter

Name	Typ	Beschreibung
latest	String	Y/N — nur Proxys aus der letzten Bestellung zurückgeben.
orderId	String	Proxys einer bestimmten orderId oder baseOrderNumber zurückgeben.
country	String	Alpha-3-Ländercode (z. B. FRA, USA).
ends	String	Y — nur Proxys, die bald ablaufen.

Beispiel

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

Antwort

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

Kopiere die id jedes zu verlängernden Proxys. Stelle sicher, dass can_prolong true ist.

Schritt 2 — Zahlungsmethode wählen

Liste die verfügbaren Zahlungssysteme auf und kopiere die gewünschte id als paymentId. Um vom Kontoguthaben zu bezahlen, kannst du diesen Schritt überspringen und einfach paymentId = 1 verwenden.

Endpunkt

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

Antwort

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

Schritt 3 — Verlängerungskosten berechnen

Berechne die Kosten vor der Zahlung. Mengen- und Laufzeitrabatte werden wie auf der Website angewendet. Dieser Schritt bucht nichts ab.

Endpunkt

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

Anfrage-Body

Name	Typ	Beschreibung
ids	Number / Array	Eine einzelne ID oder ein Array von IDs in `[ ]`, durch Kommas getrennt — aus Schritt 1.
periodId	String	ID des Verlängerungszeitraums. Verfügbare Zeiträume erhältst du über den Endpunkt `/reference/list/{type}`.
paymentId	String	Zahlungssystem-ID. `1` = Guthaben, `43` = im Konto hinterlegte Karte.
coupon (optional)	String	Ein Gutscheincode, falls vorhanden.

Beispiel

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

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

Wenn dein Guthaben zu niedrig ist, erhältst du eine Insufficient funds-Warnung:

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

Schritt 4 — Verlängerung durchführen (belastet dein Guthaben)

Wenn die berechneten Kosten passen, erstelle die Verlängerungsbestellung. Dieser Schritt belastet dein Guthaben. Verwende dieselben Parameter wie in Schritt 3.

Endpunkt

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

Anfrage-Body

Name	Typ	Beschreibung
ids	Number / Array	Eine einzelne ID oder ein Array von IDs in `[ ]`, durch Kommas getrennt.
periodId	String	ID des Verlängerungszeitraums (aus `/reference/list/{type}`).
paymentId	String	Zahlungssystem-ID. `1` = Guthaben.
coupon (optional)	String	Ein Gutscheincode, falls vorhanden.

Beispiel

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

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

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

Die Proxys behalten dieselben IPs mit einem neuen Ablaufdatum.