Zum Inhalt springen
Anmelden Registrieren

Legacy ISP-Pläne (fixierte IPs)

Veraltete ISP-Pläne stellen Ihnen eine feste Liste von IPs bereit, jeweils auf Port 1337, ausschließlich nach Land platziert. Verwenden Sie diese API, um diese IPs aufzulisten und die Whitelist der Quell-IPs zu verwalten.

Authentifizierung

Abschnitt betitelt „Authentifizierung“

Alle Endpunkte authentifizieren sich mit einem api_token-Query-Parameter. Erstellen Sie einen Token im Panel unter Account → API Tokens.

?api_token=YOUR_API_TOKEN

Der Pfadparameter {membership} akzeptiert beide Formen: die numerische ID des Plans (die Zahl, die auf der Planseite im Panel angezeigt wird) oder dessen API-ID (der kurze Code am Ende der Panel-URL des Plans, zum Beispiel https://shifter.io/panel/membership/DeeJ). Beide führen zum selben Plan.

Proxys auflisten

Abschnitt betitelt „Proxys auflisten“
GET https://shifter.io/api/v1/static-residential/{membership}/proxies

Gibt jede IP in Ihrem veralteten Plan zurück, jeweils als ip:port. Derselbe Port (1337) sowie derselbe Benutzername/dasselbe Passwort gelten für den gesamten Pool, sodass sich nur die IP ändert. Die Zugangsdaten sind nicht Teil dieser Antwort; sie befinden sich im Panel.

ParameterInRequiredDescription
membershippathjaDie Plan-ID (numerisch oder API-ID)
api_tokenqueryjaIhr Konto-API-Token

Beispiel:

Terminal-Fenster
curl "https://shifter.io/api/v1/static-residential/YOUR_PLAN_ID/proxies?api_token=YOUR_API_TOKEN"

Antwort:

{
  "error": null,
  "code": 200,
  "data": [
    "185.199.108.153:1337",
    "185.199.108.154:1337",
    "185.199.108.155:1337"
  ]
}

Jeder Eintrag ist ip:port. Der Port (1337) sowie Benutzername/Passwort sind für jede IP im Pool gleich, nur die IP ändert sich; die Zugangsdaten befinden sich auf der Planseite im Panel unter Meine Pläne. Bei einem veralteten Plan wurden die Länder, in denen sich Ihre IPs befinden, einmalig beim Kauf festgelegt und bleiben danach unverändert.

Autorisierte Quell-IPs

Abschnitt betitelt „Autorisierte Quell-IPs“

Fügen Sie Quell-IPs zur Whitelist hinzu, damit Ihre Scraper bei jeder Anfrage die HTTP-Basic-Authentifizierung überspringen können. Die Whitelist gilt für den gesamten veralteten Plan: Jede auf der Whitelist stehende Quelle kann jede darin enthaltene IP verwenden. Aktuelle ISP Proxies-Pläne unterstützen kein IP-Whitelisting; sie authentifizieren sich ausschließlich mit Benutzername und Passwort.

Autorisierte IPs auflisten

Abschnitt betitelt „Autorisierte IPs auflisten“
GET https://shifter.io/api/v1/static-residential/{membership}/authorized-ips
ParameterInRequiredDescription
membershippathjaDie Plan-ID
api_tokenqueryjaIhr Konto-API-Token

Antwort:

{
  "error": null,
  "code": 200,
  "data": [
    "198.51.100.10",
    "203.0.113.42"
  ]
}

Autorisierte IPs aktualisieren

Abschnitt betitelt „Autorisierte IPs aktualisieren“
PUT https://shifter.io/api/v1/static-residential/{membership}/authorized-ips

Ersetzt die Liste der autorisierten IPs durch die angegebenen Werte.

ParameterInRequiredDescription
membershippathjaDie Plan-ID
api_tokenqueryjaIhr Konto-API-Token
ips[]bodyjaArray von IPv4-Adressen für die Whitelist

Beispiel (formularkodiert, mit Method-Override):

Terminal-Fenster
curl -X POST "https://shifter.io/api/v1/static-residential/YOUR_PLAN_ID/authorized-ips?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&ips[]=198.51.100.10&ips[]=203.0.113.42"

Siehe auch

Abschnitt betitelt „Siehe auch“