- API Reference
- Box API
- Selling platform
Create new proxies to sell, on one slot each or as group proxies
Creates sold proxies (new listening ports) and starts them. With genMethod 1 it creates numberOfPorts ports per slot in selected_positions (or positionFrom..positionTo); with 2 it creates numberOfPorts ports that spread over all selected slots. Answers with the created rows, which contain credentials and API tokens. VLESS and Shadowsocks port types need a Premium or Business license and are refused with HTTP 403 otherwise.
/selling/generateRequest body application/json · required
0 HTTP and SOCKS5, 1 HTTP, 2 SOCKS5, 3 VLESS (Xray), 4 Shadowsocks (Xray). 3 and 4 need a Premium or Business license.
0, 1, 2, 3, 41 IPv4, 2 IPv6, 3 IPv6 then IPv4, 4 IPv4 then IPv6.
1, 2, 3, 4Expiry in epoch milliseconds.
Comma-separated IPs allowed without a password.
user:pass entries.
Generate random user:pass instead of userAuthenticationEntry.
Only these domains are reachable.
These domains are blocked.
0, 1Mbps.
0, 11, 2, 3, 40, 11, 2, 3, 40, 11, 2, 3, 4Let the customer rotate with /selling/rotate.
Minimum seconds between customer rotations.
Let the customer set the auto-rotation interval.
Auto-rotation interval in seconds; 0 off.
TCP OS fingerprint profile id (see /selling/tcp_os_profiles).
1 one slot per proxy, 2 group proxy.
1, 2Default 1Slots to use. Without it positionFrom and positionTo are required.
1 random ports, 2 sequential from genPortStart.
1, 2Default 120001trueResponses
Created rows, or the license refusal.
The caller is not trusted (not loopback, LAN, whitelisted or allowed Tailscale) and sent no valid Basic credentials. The body depends on whether "Basic auth for all API" is on. Routes that also use the panel login can answer a plain-text 401 "Unauthorized Access" instead.
VLESS or Shadowsocks port type without a Premium or Business license.
True when the box accepted the request.
Outcome code or message (see the operation's error table).
Unhandled 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 |
|---|---|---|
This function is available on Selling Platform license only. Please contact Administrator! | The license does not include the Selling Platform. | Upgrade the license. |
VLESS and Shadowsocks require a Premium or Business license | portType 3 or 4 on a license without Xray selling (HTTP 403). | Use portType 0-2 or upgrade the license. |