SOP-003: Rotate Proxies
Fresh| Field | Value |
|---|---|
| Document ID | SOP-003 |
| Version | 1.0 |
| Status | Active |
| Plan Required | Varies by method |
Overview
This SOP covers all methods to rotate proxy IP addresses, including rotating all modems, specific modems, shared proxies, and setting custom rotation intervals.
Prerequisites
- Valid API token (SOP-001)
- Plan appropriate for chosen rotation method
Rotation Methods
Method 1: Rotate All Modems
Plan Required: Essential, Plus, or Business
Endpoint
GET /api/rotateExample
curl -H "Authorization: Token YOUR_API_TOKEN" \
http://YOUR_SERVER_IP/api/rotateINFO
This rotates IP addresses for ALL connected modems simultaneously.
Method 2: Rotate Specific Modem
Plan Required: Plus or Business
Endpoint
GET /api/change_ip?index=MODEM_INDEXParameters
| Parameter | Required | Description |
|---|---|---|
index | Yes | Modem index number |
Example
# Rotate modem with index 1
curl -H "Authorization: Token YOUR_API_TOKEN" \
"http://YOUR_SERVER_IP/api/change_ip?index=1"Method 3: Rotate with Custom Token
Plan Required: Plus or Business
Use a rotation-specific token (set in Proxidize web interface) instead of the main API token.
Endpoint
GET /api/change_ip?index=MODEM_INDEX&rtoken=ROTATION_TOKENExample
curl "http://YOUR_SERVER_IP/api/change_ip?index=1&rtoken=myrotationtoken123"Use Case
Custom rotation tokens allow you to share rotation capability without exposing your main API token.
Method 4: Rotate Shared Proxy
Plan Required: Plus or Business
Endpoint
GET /api/sproxy/rotate?proxy_port=PORT&proxy_pass=PASSWORDParameters
| Parameter | Required | Description |
|---|---|---|
proxy_port | Yes | Shared proxy port number |
proxy_pass | Yes | Shared proxy password |
Example
curl "http://YOUR_SERVER_IP/api/sproxy/rotate?proxy_port=35501&proxy_pass=mypassword"Method 5: Set Custom Rotation Interval
Plan Required: Plus or Business
Configure automatic rotation at set intervals.
Endpoint
GET /api/custom_rot?index=INDEX&day=VALUE&hour=VALUE&min=VALUEParameters
| Parameter | Required | Description |
|---|---|---|
index | Yes | Modem index or "all" |
day | No* | Days (0-29) |
hour | No* | Hours (0-22) |
min | No* | Minutes (0-58) |
*Use only ONE interval parameter at a time.
Examples
# Rotate modem 5 every 2 days
curl -H "Authorization: Token YOUR_API_TOKEN" \
"http://YOUR_SERVER_IP/api/custom_rot?index=5&day=2"
# Rotate all modems every 8 hours
curl -H "Authorization: Token YOUR_API_TOKEN" \
"http://YOUR_SERVER_IP/api/custom_rot?index=all&hour=8"
# Rotate modem 3 every 30 minutes
curl -H "Authorization: Token YOUR_API_TOKEN" \
"http://YOUR_SERVER_IP/api/custom_rot?index=3&min=30"Browser URL Rotation
You can also rotate proxies by visiting a URL in your browser.
Dedicated Proxies
http://SERVER_IP/api/change_ip?index=X&token=API_TOKENShared Proxies
http://SERVER_IP/api/sproxy/rotate?proxy_port=X&proxy_pass=YNetwork Access
- External requests: Use public IP (requires port 80 forwarding)
- Same network: Use private IP
Verification Checklist
- [ ] Rotation request returns success status
- [ ] New IP appears in
/api/getinforesponse - [ ] Proxy connection works with new IP
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| Rotation failed | Modem offline | Check modem connection |
| Same IP after rotation | Carrier limitation | Try again or contact carrier |
| 403 Forbidden | Plan limitation | Upgrade plan for this feature |