Hosting through the API: subdomains, databases, cron jobs, SSL, PHP options and FTP

The short answer: the API reads your account's services and manages active hosting: plan usage, subdomains, addon domains, redirects, databases, cron jobs, SSL, PHP options, backups and FTP. Everything runs in that service's account. You read with hosting:read and change with hosting:write.

Finding the service

GET /v1/services returns every service in the account, most recent first, in pages (filter ?status=active). GET /v1/services/{id} shows the product, address, status, cycle, amount and next due date, but never passwords. While a service is unpaid, domain and username may be null. The id is what you use in every operation below.

What you can manage

Example: a subdomain for the blog

curl https://api.mozout.com/v1/services/123/subdomains -X POST \
-H "Authorization: Bearer $RLX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"root_domain": "yourcompany.com", "name": "blog", "directory": "public_html/blog"}'

Folders are always relative to the account folder, such as public_html/blog; .. and system folders are not accepted. An addon domain, or the root of a subdomain, must be active in your account (registered with us, or belonging to an active hosting plan); otherwise the answer is 409 with domain_not_owned. A domain registered elsewhere is added in cPanel.

Cron jobs without free-form commands

To create a job you give php_script (a PHP file in the account) or url (a public address to call), and the timing in schedule. The shortest interval is 5 minutes and each account can have up to 20 jobs. The address must use a domain name that resolves to public addresses, never an IP or an internal name. For other commands, use cPanel.

{ "schedule": "*/15 * * * *", "php_script": "public_html/cron.php" }

When it answers 409 or 502

Only on active hosting, on a supported server. Otherwise, 409 with not_hosting, service_not_active, server_not_supported or service_not_ready; a service from another account gives 404. If the server does not answer as expected, you get a 502. Changes are limited to 20 per minute, per hosting account, and panel logins to 5 per minute.