Troubleshooting

Fresh

Common issues and solutions for the Proxidize API.

Quick Diagnosis

---

Authentication Issues

401 Unauthorized

Symptoms:

• API returns 401 error
• "Unauthorized" message

Solutions:

Check	Fix
Token present	Add Authorization header
Token format	Use Token YOUR_TOKEN (with space)
Token valid	Regenerate from dashboard
Capitalization	"Token" must be capitalized

Correct format:

curl -H "Authorization: Token abc123xyz" http://server/api/getinfo

403 Forbidden

Symptoms:

• API returns 403 error
• Token is valid but endpoint fails

Cause: Plan doesn't support this endpoint.

Solution: Check Plan Comparison for feature availability.

---

Connection Issues

Connection Refused

Symptoms:

• Cannot connect to server
• "Connection refused" error

Solutions:

1. Check server IP

   ping YOUR_SERVER_IP

2. Verify port 80 is open

   curl http://YOUR_SERVER_IP/

3. For external access:

   • Configure port forwarding on router
   • Use public IP, not private

Timeout

Symptoms:

• Request hangs
• Eventually times out

Solutions:

Cause	Solution
Server overloaded	Wait and retry
Network issues	Check connectivity
Firewall blocking	Check firewall rules

---

Rotation Issues

IP Not Changing

Symptoms:

• Rotation returns success
• But IP remains the same

Possible Causes:

1. Carrier limitation

   • Some carriers reuse IPs
   • Try again after longer interval

2. Check actual IP

   curl -H "Authorization: Token YOUR_TOKEN" http://server/api/getinfo

3. Modem not actually connected

   • Verify modem status in dashboard

Rotation Failed

Symptoms:

• API returns error
• Modem not rotating

Solutions:

Error	Solution
Modem offline	Check USB connection
Invalid index	Verify modem index exists
Network issue	Check modem signal

---

SMS Issues

Empty SMS List

Symptoms:

• sms/get returns empty array
• Know messages were sent

Solutions:

1. Check modem index

   • Verify correct modem number

2. SIM card issues

   • Check SIM has SMS capability
   • Verify signal strength

3. Message not yet received

   • Allow time for delivery

Send SMS Failed

Symptoms:

• sms/send returns error
• Message not delivered

Solutions:

Issue	Solution
Invalid phone format	Use international format +1234567890
Message encoding	URL encode special characters
Carrier blocking	Try different carrier SIM

---

Shared Proxy Issues

Proxy Creation Failed

Symptoms:

• shared_proxy/add returns error

Common Fixes:

1. Missing parameters

   Required: index, proxy_type, auth_type
   UserAuth: + user, password
   IPAuth: + IP

2. Invalid values

   • proxy_type: Must be HTTP or SOCKS
   • auth_type: Must be UserAuth or IPAuth

3. Modem offline

   • Check modem status first

Proxy Not Working

Symptoms:

• Proxy created successfully
• But cannot connect through it

Troubleshooting:

# Test HTTP proxy
curl -x http://user:pass@SERVER:PORT https://httpbin.org/ip

# Test SOCKS proxy
curl --socks5 user:pass@SERVER:PORT https://httpbin.org/ip

Issue	Solution
Wrong credentials	Verify user/password
Port blocked	Check firewall
IP not whitelisted	Add your IP for IPAuth

---

Error Messages Reference

Error Message	Meaning	Solution
ERROR: Invalid request	Bad parameters or key	Check syntax
There was an error handling your request	Server error	Check logs
There was an error deleting SMS message(s)	Delete failed	Verify SMS ID
No modem was found with the specified phone number	Wrong phone	Check number format

---

Getting Help

If issues persist:

1. Check server logs

   • Look for detailed error messages

2. Verify with /api/getinfo

   • Confirms API is working
   • Shows modem status

3. Test with cURL

   • Eliminates client-side issues
   • Shows raw response

4. Contact support

   • Include error messages
   • Include API response
   • Include modem status