Référence de l'API REST
Cette section couvre les API de gestion des proxys : contrôle programmatique des recherches géographiques, des IP sources autorisées, des paramètres géographiques par défaut et de la liste de proxys pour les Residential Proxies, les anciens plans ISP à IP fixe et les anciens plans basés sur les ports. Les plans ISP Proxies actuels ne disposent d’aucune API de gestion ; leurs lignes de proxy se trouvent sur la page du plan dans le panneau, voir ISP Proxies.
URL de base
Section intitulée « URL de base »| Produit | URL de base |
|---|---|
| Residential Proxies | https://shifter.io/api/v1/residential |
| Anciens plans ISP (IP fixe) | https://shifter.io/api/v1/static-residential |
| Anciens plans | 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 panneau sous Account → API Keys.
curl "https://shifter.io/api/v1/residential/geo/countries?api_key=YOUR_API_KEY"Anciens plans ISP et anciens plans basés sur les ports
Section intitulée « Anciens plans ISP et anciens plans basés sur les ports »Utilisez le jeton API de votre compte comme paramètre de requête api_token. Générez-le dans le panneau sous Account → API Tokens.
curl "https://shifter.io/api/v1/static-residential/YOUR_PLAN_ID/proxies?api_token=YOUR_API_TOKEN"Le paramètre de chemin {membership} accepte soit le Membership ID affiché sur la page du plan dans le panneau (par exemple 68057), soit le code court provenant de l’URL du plan (par exemple Rxqk).
Chaque point de terminaison 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 ce point de terminaison |
404 | Membership ou ressource introuvable |
429 | Trop de requêtes, réessayez avec un backoff |
500 | Erreur interne, réessayez avec un backoff |
Substitutions de méthode
Section intitulée « Substitutions de méthode »Certains points de terminaison de gestion hérités acceptent POST avec un champ de formulaire _method=PUT comme équivalent à PUT, ce qui est utile lorsque votre client HTTP supprime les méthodes non standard.