Przejdź do głównej zawartości

Konfiguracja subkonta residential

Utwórz przez API pakiet subużytkownika z własnym limitem ruchu i listami (scenariusz resellera).

Ten przewodnik pokazuje, jak utworzyć pakiet subużytkownika z własnym limitem ruchu i listami — przydatne przy odsprzedaży.

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 1 — Utwórz pakiet subużytkownika

Utwórz pakiet subużytkownika z limitem ruchu, rotacją i wygaśnięciem. Skopiuj package_key z odpowiedzi.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/create

Treść żądania

Nazwa

Typ

Opis

traffic_limit

String

Limit ruchu w bajtach.

rotation

Number

Rotacja: -1 = sticky, 0 = na żądanie, 1..3600 = sekundy.

expired_at

String

Data wygaśnięcia pakietu.

is_link_date

Boolean

Wartość logiczna — powiąż wygaśnięcie z głównym pakietem.

Odpowiedź

{
  "status": "success",
  "data": {
    "package_key": "ab12cd34ef56",
    "rotation": 60,
    "traffic_limit": "1073741824",
    "is_active": true
  },
  "errors": []
}

Krok 2 — Utwórz listę IP w pakiecie

Utwórz listę IP w tym pakiecie, używając package_key oraz ustawień geo, export i rotation.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/add

Treść żądania

Nazwa

Typ

Opis

package_key

String

Klucz pakietu (z informacji o pakiecie).

title

String

Nazwa listy.

geo

object

Obiekt z country, region, city, isp z bazy GEO (wielkość liter ma znaczenie).

export

object

Obiekt: ports (liczba IP, maks. 1000) i ext (format eksportu).

rotation

Number

Rotacja: -1 = sticky, 0 = na żądanie, 1..3600 = sekundy.

Odpowiedź

{
  "status": "success",
  "data": {
    "id": 561,
    "title": "US Washington Garfield FIRST-STEP",
    "login": "3c8aa1d4",
    "password": "AZT62Dx3",
    "geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
    "export": { "ports": 10000, "ext": "txt" }
  },
  "errors": []
}

Krok 3 — Potwierdź pakiet

Wylistuj pakiety subużytkowników, aby potwierdzić, że wszystko jest poprawnie skonfigurowane.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/packages

Odpowiedź

{
  "status": "success",
  "data": [
    { "package_key": "ab12cd34ef56", "traffic_limit": "1073741824", "is_active": true, "expired_at": "d.m.Y" }
  ],
  "errors": []
}

Pełna dokumentacja API

Czy to odpowiedziało na twoje pytanie?