API des Proxies ISP
Utilisez cette API pour recenser votre pool d’IP proxy ISP et gérer la liste blanche des IP sources. Pour l’utilisation du proxy au niveau protocole (host:port, identifiants), consultez Produits → ISP Proxies.
Authentification
Section intitulée « Authentification »Tous les endpoints s’authentifient avec un paramètre de requête api_token. Générez un token dans le panel, sous Account → API Tokens.
?api_token=YOUR_API_TOKENLe paramètre de chemin {membership} accepte les deux formes : l’ID numérique du plan (le numéro affiché sur la page du plan dans le panneau) ou son ID d’API (le code court à la fin de l’URL du plan dans le panneau, par exemple https://shifter.io/panel/membership/DeeJ). Les deux désignent le même plan.
Lister les proxies
Section intitulée « Lister les proxies »Retourne chaque IP fixe de votre plan avec le port et les identifiants partagés. Le même port (1337) et le même identifiant/mot de passe s’appliquent à l’ensemble du pool ; seule l’IP change.
| Parameter | In | Required | Description |
|---|---|---|---|
membership | path | yes | L’ID du plan (numérique ou ID d’API) |
api_token | query | yes | Your account API token |
Exemple :
curl "https://shifter.io/api/v1/static-residential/YOUR_PLAN_ID/proxies?api_token=YOUR_API_TOKEN"Réponse :
{ "error": null, "code": 200, "data": [ "185.199.108.153:1337", "185.199.108.154:1337", "185.199.108.155:1337" ]}Chaque entrée est au format ip:port. Le port (1337) ainsi que l’identifiant et le mot de passe sont identiques pour toutes les IP du pool, seule l’IP change ; les identifiants se trouvent dans le panneau sous My Plans → ISP Proxies. Les proxys ISP sont disponibles aux États-Unis, au Canada, au Royaume-Uni, en France, en Allemagne, en Espagne et en Italie. Les pays de vos IP sont choisis une fois à l’achat puis fixes, voir Configuration du pays.
IP sources autorisées
Section intitulée « IP sources autorisées »Placez des IP sources en liste blanche afin que vos scrapers puissent s’affranchir de l’authentification HTTP Basic à chaque requête. La mise en liste blanche s’applique à l’ensemble du compte : toute source en liste blanche peut utiliser n’importe quelle IP fixe du pool.
Lister les IP autorisées
Section intitulée « Lister les IP autorisées »| Parameter | In | Required | Description |
|---|---|---|---|
membership | path | yes | The plan ID |
api_token | query | yes | Your account API token |
Réponse :
{ "error": null, "code": 200, "data": [ "198.51.100.10", "203.0.113.42" ]}Mettre à jour les IP autorisées
Section intitulée « Mettre à jour les IP autorisées »Remplace la liste des IP autorisées par les valeurs fournies.
| Parameter | In | Required | Description |
|---|---|---|---|
membership | path | yes | The plan ID |
api_token | query | yes | Your account API token |
ips[] | body | yes | Array of IPv4 addresses to whitelist |
Exemple (encodage de formulaire, avec surcharge de méthode) :
curl -X POST "https://shifter.io/api/v1/static-residential/YOUR_PLAN_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"