Starter Guide API Reference
POST /upload GET /profile POST /delete
Support

Starter Guide

To create a new link for a file:

Call /upload with domain to update

To update an existing link:

Call /upload with domain to update.

All files need to be uploaded for an update. Any existing hosted files not in the update request will be deleted.

API Reference

POST /upload

To upload or update a new file and generate a link.

Example Request
POST https://ext.tiiny.host/v1/upload
Headers:
x-api-key:
Body:

multipart/form-data

{
    "domain": "abc.tiiny.co", // optional
    "files": (binary), // accepts multiple files
}
Curl Example
curl --location 'https://ext.tiiny.host/v1/upload' \
--header 'x-api-key: XXXXX-XXXXX-XXXXXX' \
--form 'files=@"/path/to/file/file.html"'
Example Response
200
{
    "success": true,
    "data": {
        "link": "something.tiiny.site",
        "status": "active",
        "profile": {
            "quotaUsed": 5,
            "quotaLimit": 1024
        }
    }
}
400
{
    "success": false,
    "error": "LINK_LIMIT_REACHED",
    "message": "You've reached your links limit, please upgrade"
}

GET /profile

Retrieves user profile.

Example Request
GET https://ext.tiiny.host/v1/profile
Headers:
x-api-key:
Curl Example
curl --location 'https://ext.tiiny.host/v1/profile' \
--header 'x-api-key: XXXXX-XXXXX-XXXX'
Example Response
200
{
    "success": true,
    "data": {
        "links": ["abc.tiiny.site", "abc.myblog.info"],
        "quotaUsed": 5,
        "quotaLimit": 1024
    }
}

POST /delete

Deletes a link.

Example Request
POST https://ext.tiiny.host/v1/delete
Headers:
x-api-key: 
{
    "domain": "abc.tiiny.co"
}
Example Response
200
{
    "success": true,
    "data": {
        "links": ["abc.tiiny.site", "abc.myblog.info"],
        "quotaUsed": 5,
        "quotaLimit": 1024
    }
}

Support

For technical support please email support@tiiny.host