Skip to main content
The proxy module enables you to make HTTP requests to CORS protected servers… without having a dedicated backend to proxy your request.

​
Proxied API Request URL Structure

When using the ProxyBox to forward requests to a target API or service, each proxied request follows a clear URL pattern. For example: https://pbx-<proxyboxId>.pbxz.io/proxy-https/ecs-iot.com:443/api

​
URL Parts

PartExampleDescription
ProxyBox Domainhttps://pbx-<proxyboxId>.pbxz.ioThe address of your ProxyBox instance. Replace <proxyboxId> with your unique ID.
Proxy Route Type/proxy-httpsDefines how the ProxyBox connects to the target server: use proxy-https for secure upstream requests, or proxy-http for plain HTTP.
Target Hostecs-iot.comThe domain name of the target server you want to reach through the proxy.
Target Port:443The port number on the target server. Typically 443 for HTTPS or 80 for HTTP.
Target Path/apiThe path on the target server you want to access. Everything after the target host and port.

​
Full URL Pattern

Use this general pattern to construct your proxied API requests: https://{proxybox-domain}/{proxy-route-type}/{target-host}:{target-port}/{target-path} Where:
  • {proxybox-domain} → Your unique ProxyBox Domain
  • {proxy-route-type} → Either proxy-https or proxy-http
  • {target-host} → The upstream domain name
  • {target-port} → The upstream port (e.g., 443 or 80)
  • {target-path} → The endpoint path on the target server

​
Example

To forward an HTTPS request to https://ecs-iot.com:443/api through ProxyBox jrdn, the full proxied request URL would be: https://pbx-jrdn.pbxz.io/proxy-https/ecs-iot.com:443/api