Ten przewodnik pokazuje, jak odnowić (przedłużyć) posiadane proxy przez API, aby zachować te same adresy IP. Odnawiaj na czas — po wygaśnięciu IP może zostać utracone.

Każde żądanie używa Twojego osobistego klucza API z panelu konta (jak uzyskać klucz API). W poniższych przykładach zamień YOUR_API_KEY na swój klucz. Aby zapłacić z salda konta, użyj paymentId = 1.

⚠️ Ostatni krok obciąża Twoje saldo. Zawsze najpierw sprawdź koszt w kroku obliczeń.

Przebieg w skrócie

Znajdź proxy do odnowienia i skopiuj ich ID.
Wybierz metodę płatności (lub użyj salda).
Oblicz koszt odnowienia.
Wykonaj odnowienie.

Krok 1 — Znajdź proxy do odnowienia

Wylistuj aktywne proxy i skopiuj id każdego, które chcesz przedłużyć. Odnowić można tylko proxy z can_prolong: true. Zanotuj typ proxy (ipv4, ipv6, mobile, isp, mix, mix_isp) — będzie potrzebny w kolejnych krokach.

Endpoint

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

Parametry ścieżki

Nazwa	Wartość	Opis
type (opcjonalny)	`ipv4`	Typ proxy do pobrania. Jeśli pominięty, zwracane są wszystkie typy.

Opcjonalne parametry zapytania

Nazwa	Typ	Opis
latest	String	Y/N — zwróć proxy tylko z ostatniego zamówienia.
orderId	String	Zwróć proxy z określonego orderId lub baseOrderNumber.
country	String	Trzyliterowy kod kraju (np. FRA, USA).
ends	String	Y — tylko proxy, które wkrótce wygasną.

Przykład

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

Odpowiedź

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

Skopiuj id każdego proxy do odnowienia. Upewnij się, że can_prolong to true.

Krok 2 — Wybierz metodę płatności

Wylistuj dostępne systemy płatności i skopiuj wybrane id jako paymentId. Aby zapłacić z salda konta, możesz pominąć ten krok i po prostu użyć paymentId = 1.

Endpoint

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

Odpowiedź

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

Krok 3 — Oblicz koszt odnowienia

Przed zapłatą oblicz koszt. Rabaty za ilość i okres wynajmu są stosowane tak jak na stronie. Ten krok niczego nie pobiera.

Endpoint

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

Treść żądania

Nazwa	Typ	Opis
ids	Number / Array	Pojedyncze ID lub tablica ID w `[ ]`, oddzielone przecinkami — z kroku 1.
periodId	String	ID okresu odnowienia. Dostępne okresy pobierzesz z endpointu `/reference/list/{type}`.
paymentId	String	ID systemu płatności. `1` = saldo, `43` = karta dodana do konta.
coupon (opcjonalny)	String	Kod kuponu, jeśli go masz.

Przykład

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

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

Jeśli saldo jest zbyt niskie, otrzymasz ostrzeżenie Insufficient funds:

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

Krok 4 — Wykonaj odnowienie (obciąża saldo)

Gdy obliczony koszt jest odpowiedni, utwórz zamówienie odnowienia. Ten krok obciąża Twoje saldo. Użyj tych samych parametrów co w kroku 3.

Endpoint

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

Treść żądania

Nazwa	Typ	Opis
ids	Number / Array	Pojedyncze ID lub tablica ID w `[ ]`, oddzielone przecinkami.
periodId	String	ID okresu odnowienia (z `/reference/list/{type}`).
paymentId	String	ID systemu płatności. `1` = saldo.
coupon (opcjonalny)	String	Kod kuponu, jeśli go masz.

Przykład

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

Odpowiedź — returns the new order ID and your updated balance:

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

Proxy zachowują te same adresy IP z nową datą wygaśnięcia.