VPS Reseller API
Complete API documentation for managing VPS services. Create, manage, and monitor VPS instances.
Authentication
All API requests must include the following headers for authentication:
API Key
Your API key is provided when you become a reseller. Include it in every request:
X-API-KEY: your_key_hereAPI Playground
Test the API endpoints with your credentials. Enter your API key and try the requests.
Retrieve the list of all VPS products available for reselling.
Request URL
https://api.xeniahosting.com/reseller-api/vps/productsAPI Endpoints
/reseller-api/vps/productsRetrieve the list of all VPS products available for reselling.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | integer | Optional | Page number (optional) |
limit | integer | Optional | Number of results per page (optional) |
Example Request
curl -X GET "https://api.xeniahosting.com/reseller-api/vps/products" \
-H "X-API-KEY: your_key_here" \
Example Response
{
"success": true,
"data": [
{
"id": 1,
"name": "VPS Basic",
"price": 9.99,
"category": "vps"
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 50
}
}Error Codes
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API key"
}
}/reseller-api/vps/serversRetrieve the list of all VPS servers/instances.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | integer | Optional | Page number (optional) |
limit | integer | Optional | Number of results per page (optional) |
Example Request
curl -X GET "https://api.xeniahosting.com/reseller-api/vps/servers" \
-H "X-API-KEY: your_key_here" \
Example Response
{
"success": true,
"data": [
{
"id": 1,
"name": "VPS-001",
"status": "active",
"ip": "192.168.1.100",
"created_at": "2024-01-01T00:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 50
}
}Error Codes
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API key"
}
}/reseller-api/vps/serversCreate a new VPS server instance.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
product_id | integer | Required | ID of the VPS product |
hostname | string | Required | Hostname for the VPS |
Example Request
curl -X POST "https://api.xeniahosting.com/reseller-api/vps/servers" \
-H "Content-Type: application/json" \
-H "X-API-KEY: your_key_here" \
-d '{
"product_id": 1,
"hostname": "vps.example.com"
}'Example Response
{
"success": true,
"data": {
"id": 12345,
"name": "VPS-001",
"status": "pending",
"created_at": "2024-01-01T00:00:00Z"
}
}Error Codes
{
"error": {
"code": "BAD_REQUEST",
"message": "Invalid product_id"
}
}/reseller-api/vps/servers/{id}Retrieve details of a specific VPS server.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | integer | Required | Server ID |
Example Request
curl -X GET "https://api.xeniahosting.com/reseller-api/vps/servers/12345" \
-H "X-API-KEY: your_key_here" \
Example Response
{
"success": true,
"data": {
"id": 12345,
"name": "VPS-001",
"status": "active",
"ip": "192.168.1.100",
"created_at": "2024-01-01T00:00:00Z"
}
}Error Codes
{
"error": {
"code": "NOT_FOUND",
"message": "Server not found"
}
}/reseller-api/vps/servers/{id}Update a VPS server configuration.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | integer | Required | Server ID |
hostname | string | Optional | New hostname |
Example Request
curl -X PUT "https://api.xeniahosting.com/reseller-api/vps/servers/12345" \
-H "Content-Type: application/json" \
-H "X-API-KEY: your_key_here" \
-d '{
"hostname": "new-hostname.example.com"
}'Example Response
{
"success": true,
"data": {
"id": 12345,
"hostname": "new-hostname.example.com",
"updated_at": "2024-01-01T00:00:00Z"
}
}Error Codes
{
"error": {
"code": "NOT_FOUND",
"message": "Server not found"
}
}/reseller-api/vps/servers/{id}Delete a VPS server instance.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | integer | Required | Server ID |
Example Request
curl -X DELETE "https://api.xeniahosting.com/reseller-api/vps/servers/12345" \
-H "X-API-KEY: your_key_here" \
Example Response
{
"success": true,
"message": "Server deleted successfully"
}Error Codes
{
"error": {
"code": "NOT_FOUND",
"message": "Server not found"
}
}/reseller-api/vps/servers/{id}/actionsPerform an action on a VPS server (start, stop, restart, reboot, etc.).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | integer | Required | Server ID |
action | string | Required | Action to perform (start, stop, restart, reboot) |
Example Request
curl -X POST "https://api.xeniahosting.com/reseller-api/vps/servers/12345/actions" \
-H "Content-Type: application/json" \
-H "X-API-KEY: your_key_here" \
-d '{
"action": "restart"
}'Example Response
{
"success": true,
"data": {
"action": "restart",
"status": "processing",
"message": "Server restart initiated"
}
}Error Codes
{
"error": {
"code": "BAD_REQUEST",
"message": "Invalid action"
}
}Code Examples
Code examples for integrating the VPS APIs in different programming languages:
curl -X GET "https://api.xeniahosting.com/reseller-api/vps/products" \
-H "X-API-KEY: your_key_here" \
Rate Limiting
APIs have rate limits to ensure stability and performance. The default limit is 100 requests per minute per API key.
Error Handling
All error responses follow this format:
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API key"
}
}Support
Need help? Contact us through one of these channels:
Support
Partners
XeniaHosting is a Hosting Provider, with locations in Italy and Netherlands.
We offer latest generation Hardware and Networks, with high level Anti-DDoS protections.
VAT: IT01849280191 - REA: CR-337979 - Social Capital €10.000
Company under management and coordination by XeniaGroup SRL
