REST-API-Referenz
Dieser Abschnitt behandelt die Proxy-Management-APIs: programmatische Steuerung von Geo-Lookups, autorisierten Quell-IPs, Geo-Standardwerten und der Proxy-Liste für Residential-Proxys, Legacy-Pläne mit fest zugewiesenen ISP-IPs und Legacy-Pläne auf Portbasis. Aktuelle ISP-Proxies-Pläne verfügen über keine Management-API; ihre Proxy-Zeilen befinden sich auf der Plan-Seite im Panel, siehe ISP Proxies.
Basis-URLs
Abschnitt betitelt „Basis-URLs“| Produkt | Basis-URL |
|---|---|
| Residential Proxies | https://shifter.io/api/v1/residential |
| Legacy-ISP-Pläne (fest zugewiesene IPs) | https://shifter.io/api/v1/static-residential |
| Legacy-Pläne | https://shifter.io/api/v1/backconnect |
Authentifizierung
Abschnitt betitelt „Authentifizierung“Residential Proxies
Abschnitt betitelt „Residential Proxies“Übergeben Sie Ihren api_key als Query-Parameter. Erstellen Sie Schlüssel im Panel unter Account → API Keys.
curl "https://shifter.io/api/v1/residential/geo/countries?api_key=YOUR_API_KEY"Legacy-ISP-Pläne und Legacy-Portpläne
Abschnitt betitelt „Legacy-ISP-Pläne und Legacy-Portpläne“Verwenden Sie das API-Token Ihres Kontos als api_token-Query-Parameter. Erzeugen Sie es im Panel unter Account → API Tokens.
curl "https://shifter.io/api/v1/static-residential/YOUR_PLAN_ID/proxies?api_token=YOUR_API_TOKEN"Der Pfadparameter {membership} akzeptiert entweder die auf der Plan-Seite im Panel angezeigte Membership ID (zum Beispiel 68057) oder den Kurzcode aus der URL des Plans (zum Beispiel Rxqk).
Jeder Endpunkt liefert einen Standard-HTTP-Status zurück. Response-Bodies bei Fehlern enthalten ein JSON-Objekt mit error und message.
{ "error": "invalid_api_key", "message": "The provided api_key is missing or invalid"}| Status | Bedeutung |
|---|---|
200 | Erfolg |
400 | Ungültige Anfrage (fehlerhafter oder fehlender erforderlicher Parameter) |
401 | Ungültige oder fehlende Anmeldedaten |
403 | Plan erlaubt diese Funktion oder diesen Endpunkt nicht |
404 | Membership oder Ressource nicht gefunden |
429 | Zu viele Anfragen, mit Backoff erneut versuchen |
500 | Interner Fehler, mit Backoff erneut versuchen |
Methodenüberschreibungen
Abschnitt betitelt „Methodenüberschreibungen“Einige Legacy-Management-Endpunkte akzeptieren POST mit einem Formularfeld _method=PUT als Äquivalent zu PUT, was nützlich ist, wenn Ihr HTTP-Client nicht standardmäßige Methoden entfernt.