Legacy-Plans-Management-API

Diese Seite behandelt die Management-API für legacy portbasierte Pläne – Bestandskunden mit einem festen Portbereich statt des traffic-basierten Gateways. Verwenden Sie diese Endpunkte, um Quell-IPs auf die Whitelist zu setzen, die Geo-Standardwerte pro Port festzulegen und die Liste der zugewiesenen Ports abzurufen.

Hinweis

Wenn Ihr Plan auf dem neuen traffic-basierten Residential Proxies-Modell (einzelnes Gateway p.shifter.io:443) läuft, verwenden Sie stattdessen die Residential Proxies API – das Targeting im neuen Modell wird pro Anfrage im Benutzernamen kodiert und nicht als Plan-Standardwert gespeichert.

Authentifizierung

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

?api_token=YOUR_API_TOKEN

Der Pfadparameter {membership} ist Ihre Plan-ID, die im Panel auf der Plan-Seite angezeigt wird.

Autorisierte IPs

Legacy-Pläne authentifizieren sich ausschließlich über die Quell-IP – setzen Sie die IPs, von denen aus Ihre Scraper sich verbinden, auf die Whitelist.

Autorisierte IPs auflisten

GET https://shifter.io/api/v1/backconnect/{membership}/authorized-ips

Parameter	In	Erforderlich	Beschreibung
membership	path	ja	Die Plan-ID
api_token	query	ja	Ihr Account-API-Token

Beispiel:

curl "https://shifter.io/api/v1/backconnect/MEMBERSHIP_ID/authorized-ips?api_token=YOUR_API_TOKEN"

Antwort:

{
  "ips": ["198.51.100.10", "203.0.113.42"]
}

Autorisierte IPs aktualisieren

PUT https://shifter.io/api/v1/backconnect/{membership}/authorized-ips

Ersetzt die Liste der autorisierten IPs durch die angegebenen Werte.

Parameter	In	Erforderlich	Beschreibung
membership	path	ja	Die Plan-ID
api_token	query	ja	Ihr Account-API-Token
ips[]	body	ja	Array von IPv4-Adressen für die Whitelist

Beispiel (form-encoded, mit Method Override):

curl -X POST "https://shifter.io/api/v1/backconnect/MEMBERSHIP_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"

Geo-Standardwerte

Legacy-Ports haben eine Geo-Zuweisung pro Plan. Legen Sie diese einmal fest, und jeder Port im Plan wird über IPs in den konfigurierten Ländern (oder erweiterten Filtern) geroutet.

Aktuelle Geo-Zuweisung abrufen

GET https://shifter.io/api/v1/backconnect/{membership}/geo

Parameter	In	Erforderlich	Beschreibung
membership	path	ja	Die Plan-ID
api_token	query	ja	Ihr Account-API-Token

Antwort:

{
  "geo": ["us", "gb"],
  "advanced_geo": []
}

Geo-Zuweisung aktualisieren

PUT https://shifter.io/api/v1/backconnect/{membership}/geo

Parameter	In	Erforderlich	Beschreibung
membership	path	ja	Die Plan-ID
api_token	query	ja	Ihr Account-API-Token
geo[]	body	ja	Array von ISO-3166-1-Alpha-2-Ländercodes
advanced_geo[]	body	nein	Array erweiterter Geo-Filter (Stadt oder ASN)

curl -X POST "https://shifter.io/api/v1/backconnect/MEMBERSHIP_ID/geo?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&geo[]=us&geo[]=uk&geo[]=ca"

Proxys auflisten

GET https://shifter.io/api/v1/backconnect/{membership}/proxies

Gibt die Liste der host:port-Einträge für jeden Port in Ihrem Legacy-Plan zurück.

Parameter	In	Erforderlich	Beschreibung
membership	path	ja	Die Plan-ID
api_token	query	ja	Ihr Account-API-Token

Antwort:

{
  "proxies": [
    { "host": "apollo.p.shifter.io", "port": 10001 },
    { "host": "zeus.p.shifter.io", "port": 10002 },
    { "host": "cronos.p.shifter.io", "port": 10003 }
  ]
}

Method Overrides

Viele proxyfähige HTTP-Clients entfernen nicht standardmäßige Methoden. Die Management-API akzeptiert POST mit einem _method=PUT-Formularfeld als Äquivalent zu PUT.

Siehe auch

• Legacy-Portmodell
• Authentifizierung – wie sich die Legacy-Authentifizierung von Residential Proxies und ISP Proxies unterscheidet