GENERAL
Proxy Errors Troubleshooting
Explore the catalog of Oculus HTTP errors, including error codes, descriptions, and actions to resolve common proxy issues.
Proxy Configuration Format
Please note that Oculus currently supports proxy configurations only in thehost:ip format. The commonly used ip:port format is not supported and will result in connection errors. Ensure you use the server’s hostname followed by its IP address for proper integration.
HTTP Header Fields
The following fields are returned upon andHTTP or HTTPS requests:
| Field | Description | Examples |
|---|---|---|
HTTP Error | The protocol error numbers | 404 or 502 |
x-tlp-err-code | Oculus module and error code number | client_10001 |
x-tlp-error | Oculus main error message | Authentication failed |
x-tlp-err-msg | Oculus elaborated message and actions | Authentication failed. Check your credentials or your account status |
Getting HTTP header fields
Testing from command line
To view and test your settings, or restoring an issue, you can run acurl command from your shell prompt and add the option flag -v or i. These flags will run curl in verbose mode and print out the header fields, including the custom error code and message.
-i option for curl:
curl Command snippet
curl command snippet, with all required zone parameters is available in the Overview tab in Oculus control panel for the zone you are working on.
Via Programming Languages
These HTTP headers can be accessed in any programming language in the same way you would handle standard HTTP headers.Error Codes Explained
HTTP Error 400 – Bad Request
| x-tlp-err-code | x-tlp-error | x-tlp-err-msg |
|---|---|---|
client_10060 | Proxy Error: ip_requested_not_allocated_by_customer | Requested IP ##.##.##.## is not allocated to this zone. Select an IP that is allocated to this zone or skip the -ip parameter in proxy username |
HTTP Error 401 – Unauthorized
| x-tlp-err-code | x-tlp-error | x-tlp-err-msg |
|---|---|---|
client_10050 | Auth failed: IP blacklisted [IP] | Auth Failed IP blacklisted: [IP] |
HTTP Error 403 – Forbidden
| x-tlp-err-code | x-tlp-error | x-tlp-err-msg |
|---|---|---|
client_10070 | No Protocol | Protocol was missing from original request. Please add either HTTP or HTTPS and retry |
client_10080 | No Destination Host | No destination host. Destination host is missing or incorrect. Check your request parameters and try again |
client_10090 | You are trying to use Scraping Browser zone as regular proxy | You are trying to use Scraping Browser zone as regular proxy. A browser should be used to access this zone |
policy_20010 | Bad protocol | The protocol you are using to access our proxy is not supported. Oculus supports HTTP, HTTPS & SOCKS5 upon special approval. Please fix your protocol and try again |
policy_20020 | Bad port | Bad Port used |
HTTP Error 407 – Proxy Authentication Required
| x-tlp-err-code | x-tlp-error | x-tlp-err-msg |
|---|---|---|
client_10000 | Authentication failed | Invalid authentication: check credentials and retry. Oculus credentials include your account ID, zone name and password |
client_10001 | Invalid Auth | Invalid authentication: check credentials and retry |
client_10010 | Proxy Authentication Required | No proxy credentials provided. Please add credentials and try again. |
client_10020 | Account is suspended | Login to https://oculusproxies.com/ to activate your account |
client_10030 | Authentication failed | You are not allowed to access our API via this IP. Please verify your settings or whitelist this IP. |
client_10040 | KYC Required | KYC Required |
HTTP Error 429 – Too Many Requests
| x-tlp-err-code | x-tlp-error | x-tlp-err-msg |
|---|---|---|
client_10110 | Your limited trial mode account exceeded the allowed rate limits | Your limited trial mode account exceeded the allowed rate limits |