Aller au contenu
Se connecter S'inscrire

Anciens forfaits ISP (IP fixes)

Les anciens plans ISP vous fournissent une liste fixe d’IPs, chacune sur le port 1337, placées uniquement par pays. Utilisez cette API pour lister ces IPs et gérer la liste blanche des IPs sources.

Authentification

Section intitulée « Authentification »

Tous les points de terminaison 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_TOKEN

Le paramètre de chemin {membership} accepte l’une ou l’autre forme : l’ID numérique du plan (le numéro affiché sur la page du plan dans le panel) ou son ID API (le code court à la fin de l’URL du panel du plan, par exemple https://shifter.io/panel/membership/DeeJ). Les deux résolvent vers le même plan.

Lister les proxies

Section intitulée « Lister les proxies »
GET https://shifter.io/api/v1/static-residential/{membership}/proxies

Retourne chaque IP de votre plan legacy, sous la forme ip:port. Le même port (1337) ainsi que le même nom d’utilisateur/mot de passe s’appliquent à l’ensemble du pool, seule l’IP change. Les identifiants ne font pas partie de cette réponse ; ils se trouvent dans le panel.

ParameterInRequiredDescription
membershippathyesThe plan ID (numeric or API ID)
api_tokenqueryyesYour account API token

Exemple :

Fenêtre de terminal
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) et le nom d’utilisateur/mot de passe sont identiques pour chaque IP du pool, seule l’IP change ; les identifiants se trouvent sur la page du plan dans le panel sous My Plans. Sur un plan legacy, les pays dans lesquels se trouvent vos IPs ont été choisis une seule fois à l’achat et restent fixes par la suite.

IPs sources autorisées

Section intitulée « IPs sources autorisées »

Ajoutez des IPs sources à la liste blanche afin que vos scrapers puissent éviter l’authentification HTTP Basic à chaque requête. La mise en liste blanche s’applique à l’ensemble du plan legacy : toute source en liste blanche peut utiliser n’importe quelle IP de celui-ci. Les plans ISP Proxies actuels ne prennent pas en charge la mise en liste blanche d’IPs ; ils s’authentifient uniquement avec un nom d’utilisateur et un mot de passe.

Lister les IPs autorisées

Section intitulée « Lister les IPs autorisées »
GET https://shifter.io/api/v1/static-residential/{membership}/authorized-ips
ParameterInRequiredDescription
membershippathyesThe plan ID
api_tokenqueryyesYour account API token

Réponse :

{
  "error": null,
  "code": 200,
  "data": [
    "198.51.100.10",
    "203.0.113.42"
  ]
}

Mettre à jour les IPs autorisées

Section intitulée « Mettre à jour les IPs autorisées »
PUT https://shifter.io/api/v1/static-residential/{membership}/authorized-ips

Remplace la liste des IPs autorisées par les valeurs fournies.

ParameterInRequiredDescription
membershippathyesThe plan ID
api_tokenqueryyesYour account API token
ips[]bodyyesArray of IPv4 addresses to whitelist

Exemple (encodé en formulaire, avec substitution de méthode) :

Fenêtre de terminal
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"

Voir aussi

Section intitulée « Voir aussi »