API Documentation

PHP Client Example

<?php
$url = 'https://vps4you.hu/api.php';
$fields = [
    'email' => 'your@email.com',
    'apikey' => 'your_api_key',
    'json' => 1,
    'action' => 'service-list'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($fields));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);
?>
                    

All API responses are returned in JSON format.

Standard Response Fields

Example Success Response

{
    "success": true,
    "logged_in": true,
    "version": "1.6",
    "packages": { ... }
}

Example Error Response

{
    "success": false,
    "logged_in": false,
    "version": "1.6",
    "error": "Invalid login"
}

Get Packages

POST action=get-packages

Retrieve a list of available service packages.

List Services

POST action=service-list

List your active services.

Order Service

POST action=service-order

Order a new service (VPS, Web, Games).

Pay Service

POST action=service-pay

Extend a service using your balance.

Get Templates

POST action=vps-get-templates

Get available OS templates for a package or existing service.

Get Status

POST action=vps-get-status

Get the current status of a VPS or Game server.

Change Status

POST action=vps-change-status

Start, stop, or restart a server.

Reinstall

POST action=vps-reinstall

Reinstall a server with a specific template.

Set Reverse DNS

POST action=vps-set-reverse

Set the reverse DNS record for an IP.

Change Package

POST action=vps-change-package

Change VPS package or add extra resources.

Price Check Response:

{
    "success": true,
    "paydiff": 1500,
    "currency": "HUF",
    "new_package_name": "EPYC VPS 4GB",
    "new_price": 5000,
    "datediff": 1709856000,
    "new_cpu": 4,
    "new_ram": 4096,
    "new_ssd": 80,
    "new_disk": [],
    "new_extranet": 0
}

Get Resource Statistics

POST action=vps-get-rrd-data

Get CPU, Memory, Network, and Disk RRD resource statistics for a VPS.

Success Response:

{
    "success": true,
    "labels": ["22:00", "22:05", "22:10", ...],
    "cpu_points": [0.25, 0.44, 0.31, ...],
    "mem_points": [45.2, 45.3, 45.2, ...],
    "netin_points": [1.2, 0.8, 1.5, ...],
    "netout_points": [0.5, 0.6, 0.7, ...],
    "diskread_points": [0.0, 0.1, 0.0, ...],
    "diskwrite_points": [0.2, 0.5, 0.3, ...],
    "latest": {
        "cpu": 0.35,
        "mem_total_gb": 4.0,
        "mem_used_gb": 1.8,
        "mem_pct": 45.2,
        "netin": 1.25,
        "netout": 0.55,
        "diskread": 0.05,
        "diskwrite": 0.25
    }
}

Set Custom Name

POST action=vps-set-customname

Set or remove a friendly custom display name for a VPS.

List IP Addresses

POST action=vps-list-ips

Get all assigned IPv4 and IPv6 addresses and their reverse DNS (PTR) records.

Reset Control Panel Password

POST action=vps-reset-password

Generate a new secure Proxmox control panel password for the VPS and email it to the user.

List ISO Images

POST action=vps-iso-list

List all available OS installation ISO images and check the currently mounted ISO.

Mount ISO Image

POST action=vps-iso-mount

Mount an installation ISO image into the virtual CD-ROM drive.

Unmount ISO Image

POST action=vps-iso-unmount

Eject / unmount the ISO image from the virtual CD-ROM drive.

Get Firewall Status

POST action=vps-firewall-status

Check the active extra DDoS / application firewall configuration (Metin2 or FiveM protection).

Set Firewall Rules

POST action=vps-firewall-set

Enable and configure application-specific DDoS firewall protection.

Delete Firewall Rules

POST action=vps-firewall-delete

Remove extra DDoS / application firewall protection from the VPS.

Change Package

POST action=web-change-package

Change the package of a web hosting service. This action performs strict validation to ensure that the currently allocated storage (Web, Email, Database) does not exceed the limits of the new package.

Note: If the current usage exceeds the new package limits, the request will fail with a specific error message.

Get Web Hosting Info

POST action=web-get-info

Get connection info, control panel URL, server IP/FQDN, FTP port, phpMyAdmin and Webmail URLs, email settings, and storage quota.

Reset Web Control Panel Password

POST action=web-reset-password

Generate a new secure ISPConfig control panel password and send it to the user's email address.

Set Free Subdomain

POST action=web-set-subdomain

Configure a free .v4y.hu subdomain for the website (e.g. mytest -> mytest.v4y.hu).

Delete Free Subdomain

POST action=web-delete-subdomain

Remove the assigned .v4y.hu subdomain and delete its DNS A records.

Set Custom Display Name

POST action=web-set-customname

Assign a friendly custom label/name to the web hosting service.

Check Domain Availability

POST action=domain-check

Check if a domain is available for registration.

Success Response:

{
    "success": true,
    "available": true
}

Order Domain

POST action=domain-order

Register or transfer a domain.

{
  "nameservers": [
    {
      "hostname": "ns1.example.com",
      "ipv4": "1.2.3.4",
      "ipv6": "2001:db8::1"
    },
    "ns2.example.com"
  ]
}

New Owner Fields (if owner is newperson/neworg):

Set Transfer Auth Code

POST action=domain-set-transfer-authcode

Submit an auth code for a pending transfer.

Update Nameservers

POST action=domain-update-ns

Update nameservers for a domain.

{
  "nameservers": [
    {
      "hostname": "ns1.example.com",
      "ipv4": "1.2.3.4",
      "ipv6": "2001:db8::1"
    },
    "ns2.example.com"
  ]
}

Get DNSSEC Status

POST action=domain-dnssec-status

Get the current DNSSEC status and active cryptographic keys (DS or DNSKEY records) for a domain.

Success Response (Openprovider domain):

{
    "success": true,
    "provider": "openprovider",
    "is_dnssec_enabled": true,
    "keys": [
        {
            "flags": 257,
            "protocol": 3,
            "algorithm": 13,
            "public_key": "..."
        }
    ]
}

Toggle DNSSEC

POST action=domain-dnssec-toggle

Enable or disable DNSSEC for a domain. If the domain is hosted on our nameservers, the system automatically configures the local BIND zone and submits keys to the registry.

Add DNSSEC Key / DS Record

POST action=domain-dnssec-add-key

Manually add a DNSSEC key or DS record to the registry for domains using custom nameservers.

Delete DNSSEC Key / DS Record

POST action=domain-dnssec-delete-key

Remove a specific DNSSEC key or DS record from the registry.

Get Nameservers

POST action=domain-get-nameservers

Retrieve authoritative nameservers currently configured at the registry for the domain.

Set Nameservers

POST action=domain-set-nameservers

Update authoritative nameservers at the registry.

Get Auth / EPP Code

POST action=domain-get-authcode

Fetch or request the transfer authorization code (EPP code) for the domain.

List DNS Records

POST action=domain-dns-list

List all DNS records for a domain.

Add DNS Record

POST action=domain-dns-add

Add a new DNS record.

Delete DNS Record

POST action=domain-dns-delete

Delete a DNS record.

Edit DNS Record

POST action=domain-dns-edit

Edit an existing DNS record by removing the old record and adding the new one with updated values.

Export BIND Zone File

POST action=domain-dns-export

Export all DNS records as BIND zone file format.

Import BIND Zone File

POST action=domain-dns-import

Import DNS records from BIND zone file content. Existing NS records are always overwritten/replaced during this process.

Get S3 Credentials and Quota

POST action=s3-get-info

Retrieve S3 Object Storage API credentials (endpoint URL, access key, secret key) and current storage usage/quotas.

List S3 Buckets

POST action=s3-buckets-list

List all storage buckets under the S3 account, along with their size and object count.

Create S3 Bucket

POST action=s3-bucket-create

Create a new S3 object storage bucket with optional quota and access policy.

Delete S3 Bucket

POST action=s3-bucket-delete

Delete an S3 object storage bucket (the bucket must be empty).

Get Balance

POST action=user-get-balance

Get your current account balance.

Set SSH Public Key

POST action=user-set-sshpubkey

Update your SSH public key.

List Invoices

POST action=user-get-invoices

Get billing invoices issued to your account, including PDF download links, payment statuses, and amounts.

List Transactions

POST action=user-get-transactions

Get your financial transaction log (balance top-ups, service renewals/orders, refunds, etc.).