HTTP status code describing the result of the request.
200
for Success. All other numbers represent errors which are described in the errcode output below.
result
boolean
true
= Success.
false
= Failure.
errcode
string
status code 403
invalid_api_key
The server's Installatron Server Key is invalid.
invalid_argument_user
User specified is not authorized to access this data.
message
string
Message describing the result of the request. Do not rely on this to determine the success or failure of the request.
data[]
↳
id
string
Username of this user.
↳
parent
string
Reseller or admin account that owns this user's account. (ie. the account that created this user) This will be either the main administrative user of the server or a reseller who is in turn owned by the main administrative account of the server.
↳
type
enum
user
for an account with no Installatron administrative access.
reseller
for an account with Installatron administrative access. If the
user
matches the admin= value in /usr/local/installatron/etc/settings.ini then they will be have full administrative access to Installatron, otherwise they will receive reseller administrative access.
The path or URI to the home directory of this domain (without a trailing directory separator).
Important notes for URI values:
The entire URI is AES encrypted in Installatron Server's database.
To ensure correct URI syntax the username and password values should be URL-encoded.
The host portion of the URI is used to distinguish between web servers. It's considered best practice to use a web server-referencing hostname (eg., server123.host.net) or an IP address for the host portion of the URI. If this is not possible, make sure to include the server argument as documented below.
Supported protocols:
The local filesystem (including NFS shares)
SSH**
FTP
FTPS
SFTP**
** Both password and public key-based authentication are supported for the SSH and SFTP filesystem protocols; to authenticate by public key, substitute the contents of the key for the password.
Reminder: URI's that contain special characters within the username and password values must be URL-encoded per the specification RFC 3986. For example, a username of
Password for this database-user and database pair.
Note that the database-user should have full privileged access to the database.
↳
gid
int
The filesystem POSIX UID that files and folders will be created as for this website.
↳
uid
int
The filesystem POSIX GID that files and folders will be created as for this website.
↳
label
string
A value that uniquely identifies this website.
↳
language
enum
This website's default language. This is the language text strings and error messages will display in for requests involving this website. For example,
The host portion of the path URI is used to distinguish between web servers by default. If the path is not defined, and is instead determined On Demand, then the default will be NULL. If for whatever reason this NULL value doesn't correctly distinguish web servers then give this parameter a unique value for each web server.
↳
suspended
boolean
false
= This website is not suspended.
true
= This website is suspended.
↳
vhost_ip
string
The IP address each domain listed in vhosts should resolve to, enabling Installatron Server to install to vhosts that might not resolve through DNS.
Example: List all Installatron Server user's meta data
Method: curl, php, and a user's login
Installatron Product: Installatron Server
<?php$ch=curl_init();curl_setopt_array($ch,[CURLOPT_CUSTOMREQUEST=>"POST",CURLOPT_URL=>"https://{SERVER_IP}/users",CURLOPT_HTTPHEADER=>["X-API-KEY: {the key= or the key2= value from /usr/local/installatron/etc/settings.ini}","X-HTTP-Method-Override: GET","Accept: application/json"],CURLOPT_RETURNTRANSFER=>true]);if(($response=curl_exec($ch))===false){trigger_error(curl_error($ch));}curl_close($ch);var_export(json_decode($response,true));?>