API de gestion des offres historiques

Cette page couvre l’API de gestion des anciens forfaits basés sur des ports — des clients historiques disposant d’une plage fixe de ports plutôt que de la passerelle basée sur le trafic. Utilisez ces points de terminaison pour mettre en liste blanche les IP sources, définir les paramètres géographiques par défaut par port, et récupérer la liste des ports attribués.

Note

Si votre forfait utilise le nouveau modèle basé sur le trafic Residential Proxies (passerelle unique p.shifter.io:443), utilisez plutôt l’API Residential Proxies : le ciblage sur le nouveau modèle est encodé dans le nom d’utilisateur à chaque requête, et non stocké comme paramètre par défaut du forfait.

Authentification

Tous les points de terminaison s’authentifient via un paramètre de requête api_token. Générez un jeton dans le panneau, sous Account → API Tokens.

?api_token=YOUR_API_TOKEN

Le paramètre de chemin {membership} correspond à l’ID de votre forfait, indiqué dans le panneau sur la page du forfait.

IP autorisées

Les anciens forfaits s’authentifient uniquement par IP source : mettez en liste blanche les IP depuis lesquelles vos scrapers se connectent.

Lister les IP autorisées

GET https://shifter.io/api/v1/backconnect/{membership}/authorized-ips

Parameter	In	Required	Description
membership	path	yes	L’ID du forfait
api_token	query	yes	Votre jeton API de compte

Exemple :

curl "https://shifter.io/api/v1/backconnect/MEMBERSHIP_ID/authorized-ips?api_token=YOUR_API_TOKEN"

Réponse :

{
  "ips": ["198.51.100.10", "203.0.113.42"]
}

Mettre à jour les IP autorisées

PUT https://shifter.io/api/v1/backconnect/{membership}/authorized-ips

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

Parameter	In	Required	Description
membership	path	yes	L’ID du forfait
api_token	query	yes	Votre jeton API de compte
ips[]	body	yes	Tableau d’adresses IPv4 à mettre en liste blanche

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

curl -X POST "https://shifter.io/api/v1/backconnect/MEMBERSHIP_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"

Paramètres géographiques par défaut

Les anciens ports disposent d’une attribution géographique par forfait. Définissez-la une fois et chaque port du forfait sera routé via des IP situées dans les pays configurés (ou selon des filtres avancés).

Obtenir l’attribution géographique actuelle

GET https://shifter.io/api/v1/backconnect/{membership}/geo

Parameter	In	Required	Description
membership	path	yes	L’ID du forfait
api_token	query	yes	Votre jeton API de compte

Réponse :

{
  "geo": ["us", "gb"],
  "advanced_geo": []
}

Mettre à jour l’attribution géographique

PUT https://shifter.io/api/v1/backconnect/{membership}/geo

Parameter	In	Required	Description
membership	path	yes	L’ID du forfait
api_token	query	yes	Votre jeton API de compte
geo[]	body	yes	Tableau de codes pays ISO-3166-1 alpha-2
advanced_geo[]	body	no	Tableau de filtres géographiques avancés (ville ou ASN)

curl -X POST "https://shifter.io/api/v1/backconnect/MEMBERSHIP_ID/geo?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&geo[]=us&geo[]=uk&geo[]=ca"

Lister les proxys

GET https://shifter.io/api/v1/backconnect/{membership}/proxies

Renvoie la liste des entrées host:port pour chaque port de votre ancien forfait.

Parameter	In	Required	Description
membership	path	yes	L’ID du forfait
api_token	query	yes	Votre jeton API de compte

Réponse :

{
  "proxies": [
    { "host": "apollo.p.shifter.io", "port": 10001 },
    { "host": "zeus.p.shifter.io", "port": 10002 },
    { "host": "cronos.p.shifter.io", "port": 10003 }
  ]
}

Substitutions de méthode

De nombreux clients HTTP compatibles avec les proxys suppriment les méthodes non standard. L’API de gestion accepte POST avec un champ de formulaire _method=PUT comme équivalent de PUT.

Voir aussi

• Modèle basé sur les ports (ancien)
• Authentification — en quoi l’ancienne authentification diffère de celle des Residential Proxies et des ISP Proxies