Référence de l'API REST
Cette section couvre les API de gestion des proxys — le contrôle programmatique des recherches géographiques, des IP sources autorisées, des paramètres géographiques par défaut, et de la liste des proxys pour les Residential Proxies, les ISP Proxies et les plans historiques basés sur des ports.
URL de base
Section intitulée « URL de base »| Produit | URL de base |
|---|---|
| Residential Proxies | https://shifter.io/api/v1/residential |
| ISP Proxies | https://shifter.io/api/v1/static-residential |
| Plans historiques | https://shifter.io/api/v1/backconnect |
Authentification
Section intitulée « Authentification »Residential Proxies
Section intitulée « Residential Proxies »Transmettez votre api_key en tant que paramètre de requête. Créez des clés dans le panel sous Account → API Keys.
curl "https://shifter.io/api/v1/residential/geo/countries?api_key=YOUR_API_KEY"ISP Proxies et plans historiques
Section intitulée « ISP Proxies et plans historiques »Utilisez le jeton API de votre compte en tant que paramètre de requête api_token. Générez-le dans le panel sous Account → API Tokens.
curl "https://shifter.io/api/v1/static-residential/YOUR_MEMBERSHIP_ID/proxies?api_token=YOUR_API_TOKEN"Le paramètre de chemin {membership} des endpoints ISP et historiques correspond à l’ID de votre plan, affiché dans le panel sur la page du plan.
Chaque endpoint renvoie un statut HTTP standard. Les corps de réponse en cas d’échec incluent un objet JSON avec error et message.
{ "error": "invalid_api_key", "message": "The provided api_key is missing or invalid"}| Statut | Signification |
|---|---|
200 | Succès |
400 | Requête invalide (paramètre requis manquant ou mal formé) |
401 | Identifiants invalides ou manquants |
403 | Le plan ne permet pas cette fonctionnalité ou cet endpoint |
404 | Membership ou ressource introuvable |
429 | Trop de requêtes, réessayez avec un backoff |
500 | Erreur interne, réessayez avec un backoff |
Substitution de méthode
Section intitulée « Substitution de méthode »Certains endpoints de gestion historiques acceptent POST avec un champ de formulaire _method=PUT comme équivalent à PUT, utile lorsque votre client HTTP supprime les méthodes non standard.