Ten przewodnik pokazuje, jak kupić nowe proxy przez API od zera — sprawdzić dostępność, obliczyć cenę, złożyć zamówienie i pobrać kupione adresy IP.

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.

⚠️ Krok zamówienia obciąża Twoje saldo. Zawsze najpierw sprawdź koszt w kroku obliczeń.

Przebieg w skrócie

Sprawdź saldo.
Sprawdź, co można zamówić (kraj, okres).
Wybierz metodę płatności (lub użyj salda).
Oblicz cenę.
Złóż zamówienie.
Pobierz kupione proxy.

Krok 1 — Sprawdź saldo

Upewnij się, że masz wystarczające saldo na zakup.

Endpoint

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

Odpowiedź

{
  "status": "success",
  "data": { "summ": 10 },
  "errors": []
}

Krok 2 — Sprawdź, co można zamówić

Reference List zwraca wszystko, czego potrzebujesz do zamówienia: kraje, okresy, cele, operatorów i rotacje (dla mobile). Skopiuj potrzebne countryId i periodId.

Endpoint

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

Parametry ścieżki

Nazwa	Wartość	Opis
type	`ipv4`	Typ proxy (ipv4, ipv6, mobile, isp, mix, mix_isp).

Przykład

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

Odpowiedź

{
  "status": "success",
  "data": {
    "items": [
      {
        "country": [ { "id": 561, "name": "France", "alpha3": "FRA" } ],
        "period":  [ { "id": "1m", "name": "1 month" } ]
      }
    ]
  },
  "errors": []
}

Krok 3 — Wybierz metodę płatności

Wylistuj dostępne systemy płatności i skopiuj wybrane id jako paymentId. Aby zapłacić z salda, po prostu użyj 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 4 — Oblicz cenę

Oblicz cenę zamówienia przed zakupem. Rabaty za ilość i okres wynajmu są stosowane jak na stronie. Ten krok niczego nie pobiera.

Pola treści zależą od typu proxy. Wspólne pola są poniżej; dla IPv6 przekaż też protocol, dla mobile operatorId + rotationId, dla residential użyj tarifId — wszystko z Reference List.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc

Treść żądania

Nazwa	Typ	Opis
countryId	Number	ID kraju z Reference List (krok 2).
periodId	String	ID okresu wynajmu z Reference List.
quantity	Number	Liczba proxy do zamówienia.
paymentId	Number	ID systemu płatności. `1` = saldo, `43` = dodana karta.
coupon (opcjonalny)	String	Kod kuponu, jeśli go masz.
authorization (opcjonalny)	String	Metoda autoryzacji. Pozostaw puste, aby użyć login:hasło.
customTargetName (opcjonalny)	String	Własna nazwa celu/targetu, jeśli potrzeba.

Przykład

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

Odpowiedź — shows the total, your balance, the discount and the per-proxy price:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 2000,
    "total": 9,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.45,
    "price": 1.8
  },
  "errors": []
}

Krok 5 — Złóż zamówienie (obciąża saldo)

Gdy obliczona cena jest odpowiednia, złóż zamówienie. Ten krok obciąża Twoje saldo. Użyj tych samych parametrów co w kroku 4. Skopiuj orderId z odpowiedzi.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make

Treść żądania

Nazwa	Typ	Opis
countryId	Number	ID kraju z Reference List (krok 2).
periodId	String	ID okresu wynajmu z Reference List.
quantity	Number	Liczba proxy do zamówienia.
paymentId	Number	ID systemu płatności. `1` = saldo, `43` = dodana karta.
coupon (opcjonalny)	String	Kod kuponu, jeśli go masz.
authorization (opcjonalny)	String	Metoda autoryzacji. Pozostaw puste, aby użyć login:hasło.
generateAuth (opcjonalny)	String	Y/N — utwórz własną autoryzację (domyślnie N).

Przykład

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

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

{
  "status": "success",
  "data": {
    "orderId": 2426273,
    "total": 16.2,
    "listBaseOrderNumbers": [ "3388485_57471911" ],
    "balance": 1776.88
  },
  "errors": []
}

Krok 6 — Pobierz kupione proxy

Pobierz kupione proxy. Filtruj według orderId z poprzedniego kroku, aby zobaczyć dokładnie to, co kupiono.

Endpoint

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

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",
        "date_start": "23.06.2024",
        "date_end": "23.07.2024"
      }
    ]
  },
  "errors": []
}