Cladior · Reference

Proxy

Requests to your proxy URL go through Cladior first, then on to your origin. Your origin receives the request exactly as it would directly. Cladior is invisible to your backend.

Proxy base URL

Your proxy base URL is in the dashboard under the Integration card for your app. Prefix your API path with it:

URL format

https://cladior.com/p/your-token/your-path

Everything after your token is forwarded as-is to your origin URL. Query strings, request bodies, and headers all pass through unchanged.

Custom domain

If you set up a custom domain in the dashboard, requests to that domain are routed through Cladior automatically. No proxy URL prefix needed in your code.

DNS record

Type   CNAME
Name   api    (or any subdomain)
Value  cladior.com

After adding the DNS record, enter the subdomain in the dashboard under Custom Domain. Cladior provisions an SSL certificate automatically.

Status codes

Code	Meaning	SDK behaviour
200	Request forwarded, user billed.	Response returned to your code.
401	No valid session.	SDK shows the connect popup and retries after the user connects.
402	Insufficient balance.	SDK shows a top-up prompt. Request retries automatically after top-up.
403	Access revoked.	SDK clears the session and shows the connect popup.
503	Origin URL not set in the dashboard.	No SDK handling. Configure origin URL in the Integration card.