- API Reference
- Box API
- Selling platform
Let a customer get a new IP for the proxy they rent, with its token link
Rotates the slot behind one sold proxy. Works only when the seller allowed API rotation for that proxy and the last rotation is older than its minimum interval; group proxies are refused. Refusals come in data (not allowed) or message (all others).
GET
/selling/rotateQuery parameters
tokenstringrequiredsecret
API token of one sold proxy (api_token in /selling/shared_proxies). Give it only to the customer who rents that proxy; anyone with the link can use it.
Authentication
Authenticated only by the sold proxy's API token; the dashboard login and "Basic auth for all API" do not apply.
Responses
Rotation result or refusal.
Errors returned in msg
| msg | Meaning | What to do |
|---|---|---|
This function is available on Selling Platform license only. Please contact Administrator! | The license does not include the Selling Platform. | Upgrade the license. |
API Token invalid | Token unknown or reset (in message). | Ask the seller for the current link; tokens change when reset. |
Feature does not allowed for proxy group | The proxy is a group proxy (in data). | Not available for group proxies. |
Feature does not allowed | The seller did not allow API rotation (in data). | Ask the seller to enable it. |
Please waiting for next: N seconds | Minimum rotation interval not reached. | Wait N seconds. |
Proxy is not ready, try again later! | The slot has no modem right now. | Retry later. |
MODEM_STOPPED | Rotation refused by the slot (code from the rotation itself, in message). | Contact the seller. |
Try again later! | Unexpected error. | Retry later. |