Skip to Content
Browse documentation

adminsso — Reseller API

Create the caller reseller administrator login link through the Reseller API, with request fields, response details, errors and cURL/Python/PHP examples.

POST/api/v1/adminsso/Also accepts GET

Generates a signed quick-login URL for the authenticated reseller itself. There is no operation-specific user parameter: the target is taken from X-RESELLER after authentication. This logs into RAPP on HTTPS port 4444, not the root WAP panel. The token generator sets a 30-minute expiry. Treat the complete URL as a credential and do not log it, include it in analytics or follow it automatically in a backend test. The routed endpoint is adminsso; the internal handler name wapsso and its older source comment are not a public wapsso route.

Request

PropertyValue
MethodsGET, POST
Versioned path/api/v1/adminsso/
Default path/api/adminsso/
AuthenticationReseller API credentials.
HeaderRequired value
X-RESELLERThe reseller account owning these API credentials.
X-API-USERYour Reseller API username.
X-API-PASSWORDIts API password.

No endpoint-specific query or body fields are required.

Replace server.example.com, examplereseller, billing_api and YOUR_API_PASSWORD in each standalone example. Replace operation sample values with your actual target and an existing package where required. Python needs Requests; PHP needs the cURL extension. These examples make real calls when run.

Success response

HTTP 200. Illustrative values; account records and server values vary. Stored account examples show only selected fields.

{
  "data": {
    "url": "https://server.example.com:4444/quick/EXAMPLE_TOKEN"
  },
  "info": "SSO Login Url of Admin",
  "status": 200
}
FieldTypeMeaning
statusinteger200 on the documented success branch.
infostringOperation description.
dataobjectOperation data described below.
data.urlstringSigned quick-login URL; its token is a credential.

Errors and demo mode

ConditionActual HTTP statusResponse behavior
Missing credentials with no other authenticated identity403detail: Authentication credentials were not provided.
Rejected password or source IP403detail: Invalid API credentials
Demo server400error: Demo server; info: Api Operations not available in demo server; JSON status: 403.
Quick-login helper returns no URLServer errorThe current failure branch references an undefined variable; a normal operation JSON error is not guaranteed.
Unsupported method405 after authenticationMethod-not-allowed response.

Check both the HTTP status and JSON shape. Authentication failures do not use the operation envelope. Unexpected uncaught server errors are not guaranteed to return the documented JSON shape. Do not automatically retry account creation, password changes, deletions or SSO generation after a timeout: confirm the actual state first.

See Reseller API authentication and connection troubleshooting.