API Documentation - Tiiny Host

Authentication

All API requests require an API key. Include it in the request headers:

x-api-key: YOUR_API_KEY_HERE

Get your API key from your dashboard settings.

Base URL

https://api.host.naml.in/v1

Endpoints

POST/upload

Upload a new site

Parameters

Parameter	Type	Required	Description
files	file	Yes	ZIP file or HTML file to upload
domain	string	Yes	Subdomain name for your site
siteSettings	JSON	No	Additional site configuration

Example Request

                    curl -X POST https://api.host.naml.in/v1/upload \
                    -H "x-api-key: YOUR_API_KEY" \
                    -F "files=@mysite.zip" \
                    -F "domain=mysite"
                

Example Response

                    {
                    "success": true,
                    "data": {
                    "link": "mysite.host.naml.in",
                    "status": "active",
                    "profile": {
                    "quotaUsed": 5,
                    "quotaLimit": 1024
                    }
                    }
                    }
                

PUT/upload

Update an existing site

Parameters

Parameter	Type	Required	Description
files	file	No	New ZIP file or HTML file
domain	string	Yes	Subdomain of site to update
siteSettings	JSON	No	Updated site configuration

GET/profile

Get your account profile and list of sites

Example Response

                    {
                    "success": true,
                    "data": {
                    "links": ["site1.host.naml.in", "site2.host.naml.in"],
                    "quotaUsed": 150,
                    "quotaLimit": 1024
                    }
                    }
                

DELETE/delete

Delete a site

Parameters

Parameter	Type	Required	Description
domain	string	Yes	Subdomain of site to delete

Error Codes

Code	Description
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key
404	Not Found - Site does not exist
500	Server Error - Something went wrong