⚡ Stock limité — Seulement quelques routeurs disponibles. Prochain batch dans 2 semaines.

Documentation API

Automatisez la rotation de vos adresses IP depuis vos propres scripts de scraping.

Authentification

Toutes les requêtes vers l'API nécessitent une clé d'API valide. Vous pouvez générer une clé depuis votre espace client (onglet "Clés d'API"). L'authentification se fait via le header HTTP Authorization avec le schéma Bearer.

Authorization: Bearer ps_live_xxxxxxxxx

Rotation d'IP (Forcer le renouvellement)

POST

Cette route permet de forcer votre routeur dédié à se déconnecter puis se reconnecter à l'antenne mobile, obtenant ainsi une nouvelle adresse IP fraîche. Le processus prend généralement entre 3 et 8 secondes.

Endpoint
POST https://api.proxym.io/v1/proxies/{assignment_id}/rotate

Paramètres d'URL

ParamètreTypeDescription
assignment_idString (UUID)L'identifiant unique de votre proxy (trouvable sur le dashboard).

Exemple de requête (cURL)

curl -X POST https://api.proxym.io/v1/proxies/550e8400-e29b-41d4-a716-446655440000/rotate \
  -H "Authorization: Bearer ps_live_abc123..." \
  -H "Content-Type: application/json"

Réponse (Succès - 200 OK)

{
  "success": true,
  "message": "IP rotated successfully. It may take up to 10 seconds to stabilize."
}
Limites d'utilisation (Rate Limiting)

Afin de préserver la santé des équipements matériels (modems) et d'éviter les surcharges cellulaires, des limites strictes sont appliquées :

  • Maximum 1 rotation toutes les 60 secondes par port physique.
  • Toute requête supplémentaire dans ce délai renverra une erreur HTTP 429 Too Many Requests.