API Reference
Learn how to use the E-Z.host API
Base URL
All API requests should be made to:
https://api.e-z.host
Authentication
All API requests must include your API key in the key
header:
key: YOUR_API_KEY
You can obtain your API key from your E-Z Account Settings.
Available Services
The E-Z.host API provides access to three main services:
- File Upload - Upload and host files with automatic Cloudflare CDN distribution
- URL Shortener - Create short, shareable links from long URLs
- Paste Service - Create text pastes with syntax highlighting support
For detailed endpoint documentation, please refer to the specific service documentation pages:
File Upload API
Learn how to upload files using the E-Z.host API.
URL Shortener API
Learn how to shorten URLs using the E-Z.host API.
Paste API
Learn how to create pastes using the E-Z.host API.
Rate Limiting
All endpoints enforce a rate limit of 3 requests per 15 seconds per API key. If you exceed this limit, you will receive a 429 Too Many Requests
error. Rate limit information is also provided in the response headers:
Ratelimit-Limit: 3
Ratelimit-Remaining: 2
Ratelimit-Reset: 13
Error Handling
All API responses include a success
field indicating whether the request was successful. If success
is false
, the response will include an error message:
{
"success": false,
"error": "not enough rizz"
}
Common error codes:
400
- Bad Request (invalid parameters)401
- Unauthorized (invalid or missing API key)413
- Payload Too Large (file size exceeds limit)429
- Too Many Requests (rate limit exceeded)500
- Internal Server Error
SDKs
We provide official SDK libraries for popular programming languages:
Need Help?
If you need assistance with our API, feel free to:
- Ask our Discord community and staff
- Email us at support@e-z.gg