Diese Anleitung zeigt, wie du eine geo-zielgerichtete Residential-Liste mit Rotation erstellst.
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.
Schritt 1 — Paket prüfen
Stelle sicher, dass das Residential-Paket aktiv ist und Traffic übrig hat. Kopiere den package_key.
Endpunkt
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
Antwort
{
"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": []
}
Schritt 2 — Verfügbare Standorte abrufen
Lade die verfügbaren Standorte (Land / Region / Stadt / ISP) herunter, um die genauen GEO-Werte zu kennen. Die Antwort ist ein JSON/ZIP mit dem vollständigen GEO-Baum.
Endpunkt
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/geo
Antwort
[
{
"code": "US",
"name": "United States",
"regions": [
{ "name": "Washington", "cities": [ { "name": "Garfield", "isps": [ "FIRST-STEP" ] } ] }
]
}
]
Schritt 3 — Liste erstellen
Erstelle die Liste mit einem Titel, dem geo-Objekt (aus Schritt 2), den export-Einstellungen und einem Rotationswert.
Endpunkt
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Anfrage-Body
Name | Typ | Beschreibung |
title | String | Name der Liste. |
whitelist (optional) | String | IPs für die Autorisierung. Leer lassen für Login:Passwort. |
geo | object | Objekt mit |
export | object | Objekt: |
rotation | Number | Rotation: |
Beispiel
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Antwort
{
"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": []
}
Schritt 4 — Neue Liste prüfen
Liste deine Residential-Listen auf, um die Erstellung zu bestätigen und die Verbindungsdaten zu erhalten.
Endpunkt
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists
Antwort
{
"status": "success",
"data": [
{ "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
],
"errors": []
}