Skip to main content

​
Function

Remotely switches the proxy’s session mode, supporting sticky sessions (fixed IP) and rotating sessions (auto IP switching), without manual adjustments in the dashboard.

​
Applicable Scenarios

Automatically adapts to business needs (e.g., switch to sticky sessions for account login, switch to rotating sessions for data collection).

​
Call Information

  • Request URL: https://api.xxx.com/proxies/session/switch
  • Request Method: POST
  • Request Header: Authorization: Bearer [Your API Key]
  • Request Body (JSON Format, Mandatory Parameters):
{
  "session_type": "sticky",
  "sticky_duration": 120,
  "rotate_interval": 60
}

​
Example (Switch to 120-Minute Sticky Session)

  • Request Body:
{
  "session_type": "sticky",
  "sticky_duration": 120
}

​
Successful Response Example (Status Code: 200)

{
  "code": 200,
  "msg": "Session mode switched successfully. Current mode: sticky session, duration: 120 minutes.",
  "data": {
    "current_session": "sticky",
    "expire_time": "2025-12-26 15:30:00"
  }
}