REST-API-Referenz
Dieser Abschnitt behandelt die Proxy-Management-APIs — die programmatische Steuerung von Geo-Lookups, autorisierten Quell-IPs, Geo-Standardwerten und der Proxy-Liste für Residential-Proxys, ISP-Proxys und ältere portbasierte Pläne.
Basis-URLs
Abschnitt betitelt „Basis-URLs“| Produkt | Basis-URL |
|---|---|
| Residential Proxies | https://shifter.io/api/v1/residential |
| ISP Proxies | https://shifter.io/api/v1/static-residential |
| Legacy plans | https://shifter.io/api/v1/backconnect |
Authentifizierung
Abschnitt betitelt „Authentifizierung“Residential-Proxys
Abschnitt betitelt „Residential-Proxys“Ü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"ISP-Proxys und ältere Pläne
Abschnitt betitelt „ISP-Proxys und ältere Pläne“Verwenden Sie das API-Token Ihres Kontos als Query-Parameter api_token. Generieren Sie es im Panel unter Account → API Tokens.
curl "https://shifter.io/api/v1/static-residential/YOUR_MEMBERSHIP_ID/proxies?api_token=YOUR_API_TOKEN"Der Pfadparameter {membership} bei ISP- und Legacy-Endpunkten ist Ihre Plan-ID, die im Panel auf der Planseite angezeigt wird.
Jeder Endpunkt gibt 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 Zugangsdaten |
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 |
Method-Overrides
Abschnitt betitelt „Method-Overrides“Einige ältere Management-Endpunkte akzeptieren POST mit einem Formularfeld _method=PUT als Äquivalent zu PUT — nützlich, wenn Ihr HTTP-Client nicht standardmäßige Methoden entfernt.