Introduction to the SillyHost API
The SillyHost API allows you to programmatically manage your hosting account, domains, and services. Whether you want to automate deployments, monitor resource usage, or integrate SillyHost with your own tools, the API provides a comprehensive set of endpoints to do so.
Authentication
All API requests require authentication using an API key. To generate your key:
- Log into the SillyHost client area
- Navigate to Account Settings > API Access
- Click Generate New API Key
- Copy and securely store the key — it will only be shown once
Include the key in every request using the Authorization header:
Authorization: Bearer YOUR_API_KEY
Base URL
All API endpoints are accessed via: https://api.sillyhost.co.uk/v1/
Common Endpoints
- GET /account – Retrieve your account details and current resource usage
- GET /services – List all active hosting services on your account
- GET /domains – List all domains associated with your account
- POST /services/{id}/restart – Restart a specific hosting service
- GET /services/{id}/usage – Get bandwidth and disk usage statistics
- POST /dns/{domain}/records – Create a new DNS record for a domain
- DELETE /dns/{domain}/records/{id} – Delete a DNS record
Rate Limiting
The API is rate limited to 60 requests per minute per API key. If you exceed this limit, you will receive a 429 Too Many Requests response. The response headers include X-RateLimit-Remaining and X-RateLimit-Reset to help you manage your request rate.
Response Format
All responses are returned in JSON format. Successful requests return a 200 status code with a data object. Errors return appropriate HTTP status codes with an error object containing a message and code field.
Example Request
Retrieve your account details using cURL:
curl -H "Authorization: Bearer YOUR_API_KEY" https://api.sillyhost.co.uk/v1/account
For full API documentation including request and response schemas, visit the API Reference section in your client area.