- API Reference
- Box API
- Token links
Get a new public IP for a proxy with its per-port token link
Use this to let an end user rotate one proxy without the dashboard login. Works only while per-port authentication is on. Refuses with HTTP 401 reset_too_much when the last rotation was less than the minimum interval (5 seconds by default) ago; otherwise behaves like /reset.
/{token}/resetPath parameters
Per-port token of the proxy, shown in the panel when per-port authentication is on. Treat it like a password: anyone with the link can use it.
Query parameters
Proxy address as HOST:PORT, for example 192.0.2.10:4001. Only the port selects the slot.
192.0.2.10:4001Authentication
Authenticated only by the token in the path; the dashboard login and "Basic auth for all API" do not apply. Refusals answer HTTP 401 with a message.
Responses
Rotation accepted or refused (same codes as /reset).
True when the box accepted the request.
Outcome code or message (see the operation's error table).
Per-port authentication off, wrong token, port without a modem, or rotated too recently.
Not support!, Unauthorized!, Wrong port!, reset_too_muchUnhandled error, for example a non-integer position or a missing required parameter.
Error name, e.g. internal_server_error or bad_request.
Errors returned in msg
| msg | Meaning | What to do |
|---|---|---|
Not support! | Per-port authentication is off on this box. | Turn on per-port authentication in the proxy settings. |
Unauthorized! | The token does not match this port. | Copy the link again from the panel. |
Wrong port! | No modem uses the port in proxy. | Check the proxy value. |
reset_too_much | The last rotation was less than the minimum interval ago. | Wait a few seconds and retry. |