Ten przewodnik pokazuje, jak utworzyć geotargetowaną listę proxy residential z rotacją.
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 — Sprawdź pakiet
Sprawdź, czy pakiet residential jest aktywny i ma ruch. Skopiuj package_key.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
Odpowiedź
{
"status": "success",
"data": {
"rotation": 60,
"traffic_limit": "7516192768",
"traffic_usage": "10",
"traffic_left": "10",
"package_key": "1234567890abcdefedcb",
"expired_at": "d.m.Y",
"is_active": true,
"tarif_id": 2
},
"errors": []
}
Krok 2 — Pobierz dostępne lokalizacje
Pobierz dostępne lokalizacje (kraj / region / miasto / ISP), aby poznać dokładne wartości GEO. Odpowiedź to JSON/ZIP z pełnym drzewem GEO.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/geo
Odpowiedź
[
{
"code": "US",
"name": "United States",
"regions": [
{ "name": "Washington", "cities": [ { "name": "Garfield", "isps": [ "FIRST-STEP" ] } ] }
]
}
]
Krok 3 — Utwórz listę
Utwórz listę z tytułem, obiektem geo (z kroku 2), ustawieniami export i wartością rotacji.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Treść żądania
Nazwa | Typ | Opis |
title | String | Nazwa listy. |
whitelist (opcjonalny) | String | Adresy IP do autoryzacji. Pozostaw puste dla login:hasło. |
geo | object | Obiekt z |
export | object | Obiekt: |
rotation | Number | Rotacja: |
Przykład
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
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 4 — Sprawdź nową listę
Wylistuj swoje listy residential, aby potwierdzić utworzenie i pobrać dane połączenia.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists
Odpowiedź
{
"status": "success",
"data": [
{ "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
],
"errors": []
}